Get dependent agents for multiple documents

POST

/v1/convai/knowledge-base/dependent-agents

POST

/v1/convai/knowledge-base/dependent-agents

$ curl -X POST https://api.elevenlabs.io/v1/convai/knowledge-base/dependent-agents \
>      -H "Content-Type: application/json" \
>      -d '{
>   "document_ids": [
>     "21m00Tcm4TlvDq8ikWAM",
>     "31m00Tcm4TlvDq8ikWBM"
>   ]
> }'

1 {
2   "agents": [
3     {
4       "type": "available",
5       "access_level": "admin",
6       "created_at_unix_secs": 1685600000,
7       "id": "agent_9f8b7c6d5e4a3b2c1d0e",
8       "name": "Customer Support Bot",
9       "referenced_resource_ids": [
10         "41m00Tcm4TlvDq8ikWCM"
11       ]
12     }
13   ],
14   "has_more": true,
15   "branches": [
16     {
17       "agent_id": "agent_9f8b7c6d5e4a3b2c1d0e",
18       "agent_name": "Customer Support Bot",
19       "branch_id": "branch_123abc456def",
20       "branch_name": "Main Production",
21       "is_main": true
22     }
23   ],
24   "next_cursor": "cursor_eyJwYWdlIjoxfQ=="
25 }

Get a list of agents depending on any of the given knowledge base documents.

Query parameters

dependent_typeenumOptional

Type of dependent agents to return.

Allowed values:

page_sizeintegerOptional1-100Defaults to 30

How many documents to return at maximum. Can not exceed 100, defaults to 30.

cursorstring or nullOptional

Used for fetching next page. Cursor is returned in the response.

Request

This endpoint expects an object.

document_idslist of stringsRequired

The ids of documents or folders from the knowledge base.

Response

Successful Response

agentslist of objects

has_moreboolean

brancheslist of objects

next_cursorstring or null

Errors

422

Unprocessable Entity Error

Headers

Query parameters

Request

Response

Errors