Skip to main content
GET

List Actions

Retrieve all actions associated with a specific voice agent. This endpoint returns a list of webhooks, call transfers, holds, and other actions that the agent can perform during conversations.

Endpoint

Path parameters

string
required
The unique identifier of the voice agent.

Request headers

string
required
Bearer token for authentication. Format: Bearer talq_your_environment_token_here

Example requests

Response

Success Response (200 OK)

Response fields

boolean
required
Indicates if the operation was successful.
array
required
Array of action objects associated with the agent.

Error responses

404 Not Found

401 Unauthorized

403 Forbidden

500 Server Error

Error codes

Important notes

Empty response is normal. If an agent has no actions configured, the response will be an empty array [] rather than an error.
Status filtering. The response includes both active and inactive actions. You can filter by current_status on the client side if needed.
Action types vary. Different action types (webhook, transfer, hold) have different properties and configurations.
  • Create/Update Action: POST /api/v1/agents/{agent_id}/actions
  • Delete Action: DELETE /api/v1/agents/{agent_id}/actions/{action_id}
  • Get Agent: GET /api/v1/agents/{agent_id}
  • List Agents: GET /api/v1/agents