Documentation Index

Fetch the complete documentation index at: https://docs.unpod.dev/llms.txt

Use this file to discover all available pages before exploring further.

{
  "count": 94,
  "status_code": 200,
  "message": "Agents fetched successfully",
  "data": [
    {
      "handle": "space-agent-8qmk42nslp91wrh3dz7btxc4",
      "name": "General Agentic",
      "type": "Voice",
      "state": "published",
      "purpose": "Handle outbound sales calls"
    }
  ]
}

​

Get All Agents

​

Headers

​

Response Fields

​

Agent Object Fields

​

Common Error Codes

​

Code Examples

const axios = require('axios');

const headers = {
  'Authorization': 'Token your-api-token',
  'Org-Handle': 'your-org-handle'
};

// Get all agents
const getAllAgents = async () => {
  const response = await axios.get(
    'https://unpod.ai/api/v2/platform/agents/',
    { headers }
  );
  console.log(`Total agents: ${response.data.count}`);
  response.data.data.forEach(agent => {
    console.log(`${agent.name} (${agent.handle}) - ${agent.state}`);
  });
  return response.data.data;
};

// Example usage
getAllAgents();

​

Best Practices

1. Agent Handle: Note the handle field — it is used as the agent_handle path parameter in other agent endpoints
2. State Filtering: Filter by state in your application to show only published agents
3. Org-Handle: Always include the correct organization handle in requests
4. Error Handling: Always handle potential errors and edge cases
5. Security: Keep API tokens secure and rotate them regularly