curl -X POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/dependent-agents?dependent_type=direct&page_size=30&cursor=example-cursor' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "document_ids": [
    "string"
  ]
}'

# POST /v1/convai/knowledge-base/dependent-agents (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Get Dependent Agents For Multiple Documents

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/dependent-agents?dependent_type=direct&page_size=30&cursor=example-cursor' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"document_ids":["string"]}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| document_ids | body | string[] | Yes | The ids of documents or folders from... |
| dependent_type | query | string | No | Type of dependent agents to return. |
| page_size | query | integer | No | How many documents to return at maxim... |

## Response (200 OK)
{"agents":[{}],"branches":[{}]}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

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

ElevenLabs API

Get Dependent Agents For Multiple Documents

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 218 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/dependent-agents?dependent_type=direct&page_size=30&cursor=example-cursor' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "document_ids": [    "string"  ]}'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
dependent_type	query	string	No	Type of dependent agents to return.
page_size	query	integer	No	How many documents to return at maximum. Can not exceed 100, defaults to 30.
cursor	query	string	No	Used for fetching next page. Cursor is returned in the response.
document_ids	body	string[]	Yes	The ids of documents or folders from the knowledge base.

Response 200 OK

{
  "agents": [
    {
      "referenced_resource_ids": [
        "string"
      ],
      "id": "string",
      "name": "string",
      "type": "available",
      "created_at_unix_secs": 0,
      "access_level": "admin"
    }
  ],
  "branches": [
    {
      "agent_id": "string",
      "agent_name": "string",
      "branch_id": "string",
      "branch_name": "string",
      "is_main": true
    }
  ],
  "next_cursor": "string",
  "has_more": true
}