List deployment history
One record per deploy attempt, most recent first. Configuration edits do not appear here — they require no deployment.
Authorization
personalAccessToken Personal Access Token of a Dynamiq user — the only credential accepted by the management API (api.*). Prefix dyn_pat_ (legacy uak_ tokens still authenticate). Send as Authorization: Bearer <token>.
In: header
Path Parameters
Voice agent UUID.
Query Parameters
Page number (1-based).
Number of items per page. Values below the minimum or above the maximum are clamped to the nearest bound.
Comma-separated sort fields. Prefix a field with - for descending order, e.g. sort=-started_at.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents/voice/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/deployments"{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"voice_agent_id": "2fc8d568-5ce2-4e51-baa8-38c877b5dd08",
"status": "running",
"worker_version": "string",
"error": "string",
"started_at": "2019-08-24T14:15:22Z",
"started_by": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"email": "string"
},
"ended_at": "2019-08-24T14:15:22Z",
"ended_by": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"email": "string"
}
}
],
"pagination": {
"page": 0,
"page_size": 0,
"page_count": 0,
"total_count": 0
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized"
}
}{
"error": {
"code": "not_found",
"message": "Not Found"
}
}Undeploy a voice agent
Removes the hosted worker and deactivates phone routing. The agent returns to `draft` and stays editable and testable. Telephony is torn down as part of this. Accepted only when the agent is `deployed` or `failed`; undeploying an agent that is already back to `draft` is rejected with `400`.
Create a WebRTC session
Mints a short-lived realtime session for a browser or mobile client. Call this from your server and hand the client only `url` and `token` — the Personal Access Token must never reach the client. Note this response is **bare**: it is not wrapped in a `data` envelope.