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

# Agent knowledge

> List, attach and detach the knowledge items an agent answers from.

<Note>
  These endpoints are for the VIP plan only. Other plans get a `403`. See [Plan access](/api-reference/introduction#plan-access).
</Note>

An agent answers questions from the knowledge items attached to it. Add items to the workspace's library first, in the dashboard or with the knowledge endpoints. The item must be in the agent's workspace.

## List an agent's knowledge

`GET /v1/agents/{agentId}/knowledge`

Returns the attached items.

```json Response theme={null}
[
  { "knowledgeItemId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "name": "Pricing FAQ", "type": "text", "attachedAt": "2026-10-11T10:00:00Z" }
]
```

## Attach knowledge

`POST /v1/agents/{agentId}/knowledge`

<ParamField body="knowledgeItemId" type="string" required>
  A knowledge item in the agent's workspace.
</ParamField>

We read the item's content and load it into the agent before we answer, so this can take a while for a large website or file. If the content cannot be read, nothing is attached. Returns `201` with the attached item.

If the request times out, list the agent's knowledge before you try again. The attach may have finished. A `409` means the item is already attached.

## Detach knowledge

`DELETE /v1/agents/{agentId}/knowledge/{knowledgeItemId}`

The agent stops answering from the item. The item stays in the library. Returns `204`.

## Errors

| Status | When |
| - | - |
| `400` | An id is not a valid UUID. |
| `404` | The agent or the item is not in your API key's scope, or the item is not attached. |
| `409` | The item is already attached. |
| `422` | The item's content could not be read, for example a website that blocks us. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.