{ "opencollection": "1.0.0", "info": { "name": "Agno API Reference A2A Agents API", "version": "2.5.6" }, "items": [ { "info": { "name": "Agents", "type": "folder" }, "items": [ { "info": { "name": "List Agent Runs", "type": "http" }, "http": { "method": "GET", "url": "https://api.agno.com/agents/:agent_id/runs", "params": [ { "name": "agent_id", "value": "", "type": "path" }, { "name": "session_id", "value": "", "type": "query", "description": "Session ID to list runs for" }, { "name": "status", "value": "", "type": "query", "description": "Filter by run status (PENDING, RUNNING, COMPLETED, ERROR)" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "List runs for an agent within a session, optionally filtered by status.\n\nUseful for monitoring background runs and viewing run history." }, { "info": { "name": "Create Agent Run", "type": "http" }, "http": { "method": "POST", "url": "https://api.agno.com/agents/:agent_id/runs", "params": [ { "name": "agent_id", "value": "", "type": "path" } ], "body": { "type": "multipart-form", "data": [] }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Execute an agent with a message and optional media files. Supports both streaming and non-streaming responses.\n\n**Features:**\n- Text message input with optional session management\n- Multi-media support: images (PNG, JPEG, WebP), audio (WAV, MP3), video (MP4, WebM, etc.)\n- Document processing: PDF, CSV, DOCX, TXT, JSON\n- Real-time streaming responses with Server-Sent Events (SSE)\n- User and session context preservation\n\n**Streaming Response:**\nWhen `stream=true`, returns SSE events with `event` a" }, { "info": { "name": "Cancel Agent Run", "type": "http" }, "http": { "method": "POST", "url": "https://api.agno.com/agents/:agent_id/runs/:run_id/cancel", "params": [ { "name": "agent_id", "value": "", "type": "path" }, { "name": "run_id", "value": "", "type": "path" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Cancel a currently executing agent run. This will attempt to stop the agent's execution gracefully.\n\n**Note:** Cancellation may not be immediate for all operations." }, { "info": { "name": "Continue Agent Run", "type": "http" }, "http": { "method": "POST", "url": "https://api.agno.com/agents/:agent_id/runs/:run_id/continue", "params": [ { "name": "agent_id", "value": "", "type": "path" }, { "name": "run_id", "value": "", "type": "path" } ], "body": { "type": "form-urlencoded", "data": [] }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Continue a paused or incomplete agent run with updated tool results.\n\n**Use Cases:**\n- Resume execution after tool approval/rejection\n- Provide manual tool execution results\n- Resume after admin approval (tools can be empty; resolution fetched from DB)\n\n**Tools Parameter:**\nJSON string containing array of tool execution objects with results.\nCan be empty when an admin-required approval has been resolved." }, { "info": { "name": "List All Agents", "type": "http" }, "http": { "method": "GET", "url": "https://api.agno.com/agents", "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve a comprehensive list of all agents configured in this OS instance.\n\n**Returns:**\n- Agent metadata (ID, name, description)\n- Model configuration and capabilities\n- Available tools and their configurations\n- Session, knowledge, memory, and reasoning settings\n- Only meaningful (non-default) configurations are included" }, { "info": { "name": "Get Agent Details", "type": "http" }, "http": { "method": "GET", "url": "https://api.agno.com/agents/:agent_id", "params": [ { "name": "agent_id", "value": "", "type": "path" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve detailed configuration and capabilities of a specific agent.\n\n**Returns comprehensive agent information including:**\n- Model configuration and provider details\n- Complete tool inventory and configurations\n- Session management settings\n- Knowledge base and memory configurations\n- Reasoning capabilities and settings\n- System prompts and response formatting options" }, { "info": { "name": "Get Agent Run", "type": "http" }, "http": { "method": "GET", "url": "https://api.agno.com/agents/:agent_id/runs/:run_id", "params": [ { "name": "agent_id", "value": "", "type": "path" }, { "name": "run_id", "value": "", "type": "path" }, { "name": "session_id", "value": "", "type": "query", "description": "Session ID for the run" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve the status and output of an agent run. Use this to poll for background run completion.\n\nRequires the `session_id` that was returned when the run was created." } ] } ], "bundled": true }