Documentation Index Fetch the complete documentation index at: https://docs.litellm-agent-platform.ai/llms.txt
Use this file to discover all available pages before exploring further.
Returns all agents owned by the authenticated user, newest first by default. Use search to filter by name, ID, or harness, and sort / order to change the ordering.
Request GET /api/v1/managed_agents/agents
Headers Header Value AuthorizationBearer <MASTER_KEY>
Query parameters Maximum number of agents to return. Clamped to the range 1–200.
Number of records to skip before returning results. Use with limit to page through results.
sort
string
default: "created_at"
Field to sort by. One of: created_at, name, harness_id, sessions. sessions sorts by total session count descending (or ascending with order=asc).
Sort direction. One of: asc, desc.
Case-insensitive substring match against agent name, agent ID, and harness ID. When omitted, all agents are returned.
Response Page of agent objects. Human-readable name. null if not set at create time.
LiteLLM model string, e.g. anthropic/claude-sonnet-4-6.
System prompt injected into every session. null if none.
Harness binary that runs in the sandbox pod. One of: opencode, claude-agent-sdk, claude-code, codex.
true for TUI harnesses (claude-code, codex) that expose a PTY over /tty. false for API harnesses (opencode, claude-agent-sdk).
Git repository cloned into the sandbox at session start. null if none.
Git branch to check out. Defaults to main.
Profile picture URL shown in the web UI. null if not set.
MCP server connection strings passed to the harness.
Agent-level environment variables injected into every session container. Values are decrypted before being returned.
IDs of skills currently attached to this agent, in attach order.
Allowed outbound domains for the sandbox network policy.
Blocked outbound domains for the sandbox network policy.
ISO 8601 creation timestamp.
Total number of agents matching the query (before pagination).
Effective page size used for this response.
Effective offset used for this response.
Example curl "https://<your-platform-host>/api/v1/managed_agents/agents?limit=2&sort=created_at&order=desc" \ -H "Authorization: Bearer $MASTER_KEY "
{ "data" : [ { "id" : "agt_01j9xyz" , "name" : "code-reviewer" , "model" : "anthropic/claude-sonnet-4-6" , "prompt" : "You review pull requests." , "harness_id" : "claude-agent-sdk" , "supports_tui" : false , "repo_url" : "https://github.com/BerriAI/litellm" , "branch" : "main" , "pfp_url" : null , "mcp_servers" : [], "env_vars" : {}, "attached_skill_ids" : [], "allow_out" : [], "deny_out" : [], "created_at" : "2025-05-01T12:00:00.000Z" } ], "total" : 1 , "limit" : 2 , "offset" : 0 }