Overview
Create and manage voice agents (workflows) via the API
In Paladin, a voice agent is called a workflow in the API. A workflow defines the conversation flow, LLM configuration, voice settings, and tools available to your agent.
| Method | Endpoint | Quick Link |
|---|---|---|
POST | /workflow/create/definition | Create from definition |
POST | /workflow/create/template | Create from template |
GET | /workflow/fetch | List agents |
GET | /workflow/count | Get agent count |
GET | /workflow/fetch/{workflow_id} | Get an agent |
PUT | /workflow/{workflow_id} | Update an agent |
PUT | /workflow/{workflow_id}/status | Archive an agent |
POST | /workflow/{workflow_id}/validate | Validate a workflow |
POST | /workflow/{workflow_id}/runs | Create test run |
GET | /workflow/{workflow_id}/runs | List runs |
GET | /workflow/{workflow_id}/runs/{run_id} | Get a run |
How to use this reference#
Use this page as the entry point for the related API endpoints. Open the endpoint-specific page when you need the exact method, path, request body, response schema, and OpenAPI details.
Implementation checklist#
- Start with the overview table to choose the correct endpoint.
- Confirm authentication and organization scope before calling the endpoint from code.
- Test with a small request first, then inspect the response and error handling path.