Skip to main content

​
Agent API

The Agent API allows you to manage and retrieve AI agents configured in your Unpod platform. Agents are voice AI entities that handle calls, follow personas, and execute tasks.
Prerequisites: Make sure you have your API Token and Org-Handle ready. See Authentication for details.

​
What You Can Do

EndpointDescription
GET /api/v2/platform/agents/Retrieve all agents in your organization
GET /api/v2/platform/agents/{agent_handle}/tasks/Retrieve all tasks assigned to a specific agent
GET /api/v2/platform/agents/{agent_handle}/executions/Retrieve all executions for a specific agent

​
Base URL

https://unpod.dev/api/v2/platform/

​
Authentication

All Agent API requests require a valid API token and Org-Handle in the headers: 
Authorization: Token your-api-token
Org-Handle: your-org-handle

​
Common Error Codes

Status CodeDescription
200Success - Request completed successfully
401Unauthorized - Invalid or missing API token
403Forbidden - Access denied to the resource
404Not Found - Agent not found
500Internal Server Error - Server-side error