---
title: "Get Dependent Agents List"
method: GET
path: "/v1/convai/knowledge-base/{documentation_id}/dependent-agents"
tags: ["Agents Platform"]
---

# Get Dependent Agents List

`GET /v1/convai/knowledge-base/{documentation_id}/dependent-agents`

Get a list of agents depending on this knowledge base document

## Path parameters

- `documentation_id` string, required — The id of a document from the knowledge base. This is returned on document addition.

## Query parameters

- `dependent_type` 'direct' | 'transitive' | 'all'
- `page_size` integer — How many documents to return at maximum. Can not exceed 100, defaults to 30.
- `cursor` string, nullable — Used for fetching next page. Cursor is returned in the response.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetKnowledgeBaseDependentAgentsResponseModel
  - `agents` union[], required
    - union
      - DependentAvailableAgentIdentifier
        - `referenced_resource_ids` string[] — If the agent is a transitive dependent, contains IDs of the resources that the agent depends on directly.
        - `id` string, required
        - `name` string, required
        - `type` 'available'
        - `created_at_unix_secs` integer, required
        - `access_level` 'admin' | 'editor' | 'commenter' | 'viewer', required
      - DependentUnknownAgentIdentifier — A model that represents an agent dependent on a knowledge base/tools to which the user has no direct access.
        - `referenced_resource_ids` string[] — If the agent is a transitive dependent, contains IDs of the resources that the agent depends on directly.
        - `id` string, required
        - `type` 'unknown'
  - `branches` DependentBranchInfo[]
    - `agent_id` string, required
    - `agent_name` string, required
    - `branch_id` string, required
    - `branch_name` string, required
    - `is_main` boolean, required
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/e77a0a530a82/schema)