---
title: "Get Agent Subagent Dependents"
method: GET
path: "/v1/convai/agents/{agent_id}/subagent-dependents"
tags: ["Agents Platform"]
---

# Get Agent Subagent Dependents

`GET /v1/convai/agents/{agent_id}/subagent-dependents`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/convai/agents/{agent_id}/subagent-dependents`
- Auth: none declared
- TypeScript: <https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/docs/v1/convai/agents/:agent_id/subagent-dependents/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of agents that use this agent as a subagent.

## Path parameters

- `agent_id` string, required: The id of an agent. This is returned on agent creation.

## Query parameters

- `page_size` integer: How many Agents 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

- GetAgentSubagentDependentsResponseModel: Agents and branches that use an agent as a subagent.
  - `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

## Changes

- **2026-11-12** `bb531da5449d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/agents/:agent_id/subagent-dependents/get.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/bb531da5449d?raw)