cURL
curl --request GET \ --url https://control-plane.kubiya.ai/api/v1/agents/{agent_id} \ --header 'Authorization: <api-key>'
{ "id": "<string>", "organization_id": "<string>", "name": "<string>", "description": "<string>", "system_prompt": "<string>", "status": "<string>", "capabilities": [ "<unknown>" ], "configuration": {}, "model_id": "<string>", "llm_config": {}, "runtime": "<string>", "runner_name": "<string>", "team_id": "<string>", "created_at": "<string>", "updated_at": "<string>", "last_active_at": "<string>", "state": {}, "error_message": "<string>", "projects": [ {} ], "environments": [ {} ], "skill_ids": [ "<string>" ], "skills": [ {} ], "execution_environment": { "env_vars": {}, "secrets": [ "<string>" ], "integration_ids": [ "<string>" ], "mcp_servers": {} } }
Get a specific agent by ID
Successful Response
Projects this agent belongs to
Environments this agent is deployed to
IDs of associated skills
Associated skills with details
Execution environment configuration for agents/teams
Show child attributes
Environment variables (key-value pairs)
Secret names from Kubiya vault
Integration UUIDs for delegated credentials
MCP (Model Context Protocol) server configurations. Supports stdio, HTTP, and SSE transports.
Unified MCP server configuration supporting multiple transport types.
This schema uses discriminated union based on the presence of 'command' or 'type' field:
The configuration is validated to ensure only one transport type is specified.
Command for stdio transport (mutually exclusive with url/type)
Arguments for stdio transport
Environment variables (used by both stdio and HTTP transports)
Transport type for HTTP/SSE (mutually exclusive with command)
http
sse
URL for HTTP/SSE transport (mutually exclusive with command)
HTTP headers for HTTP/SSE transport
Was this page helpful?