> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rippletide.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List knowledge items

> View source knowledge attached to an evaluation agent.

# List Knowledge Items

View the source knowledge attached to an evaluation agent.

Use this before editing or deleting knowledge so you can inspect the current
source facts and answers connected to the agent.

## Endpoint

```http theme={null}
GET /api/agents/{id}/config
```

## Authentication

Send your platform API key in the `x-api-key` header.

## Path Parameters

| Name | Type           | Description          |
| ---- | -------------- | -------------------- |
| `id` | `string<uuid>` | Evaluation agent ID. |

## Query Parameters

| Name   | Type     | Description                                         |
| ------ | -------- | --------------------------------------------------- |
| `type` | `string` | Use `knowledge` to list evaluation knowledge items. |

## Success Response

Returns `200 OK` with an array of knowledge items.


## OpenAPI

````yaml get /api/agents/{id}/config
openapi: 3.0.3
info:
  title: Rippletide Agent Evaluation API
  description: >-
    Public API for evaluation agents, test prompts, test results, and knowledge
    imports
  version: 1.0.0
  contact:
    name: Rippletide API Support
servers:
  - url: https://agent-evalserver-production.up.railway.app
    description: Production server
  - url: http://localhost:3001
    description: Development server
security: []
paths:
  /api/agents/{id}/config:
    get:
      tags:
        - Knowledge
      summary: List knowledge items
      description: >-
        List knowledge items attached to an evaluation agent. Use this to
        inspect source answers or facts that support your evaluation questions.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Evaluation agent ID.
        - name: type
          in: query
          schema:
            type: string
            enum:
              - knowledge
            default: knowledge
          description: Filter to knowledge items.
      responses:
        '200':
          description: Knowledge items
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/KnowledgeItem'
              examples:
                knowledge:
                  summary: Knowledge items
                  value:
                    - id: 12
                      label: Refund policy
                      description: >-
                        Customers can request a refund within 30 days of
                        purchase.
                      type: knowledge
                      node_count: 3
                      created_at: '2026-06-02T15:08:00Z'
                      updated_at: '2026-06-02T15:08:00Z'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Agent not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    KnowledgeItem:
      type: object
      description: Knowledge entry attached to an evaluation agent.
      properties:
        id:
          type: integer
          description: Knowledge item identifier.
          example: 12
        label:
          type: string
          description: Question, title, or short label for the knowledge item.
          example: Refund policy
        description:
          type: string
          description: Answer or source content used during evaluation.
          example: Customers can request a refund within 30 days of purchase.
        type:
          type: string
          enum:
            - knowledge
          description: Public evaluation workflows should use knowledge.
          example: knowledge
        node_count:
          type: integer
          nullable: true
          description: Number of graph nodes created from this item, when available.
          example: 3
        created_at:
          type: string
          format: date-time
          description: Creation timestamp.
          example: '2026-06-02T15:08:00Z'
        updated_at:
          type: string
          format: date-time
          description: Last update timestamp.
          example: '2026-06-02T15:08:00Z'
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        details:
          type: string
          nullable: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Platform API key for authenticated account-level API access

````