Dynamiq
PlatformPython SDKAPI Reference
Voice Agents

Disconnect phone numbers

Removes the trunk and its routing rule. Inbound calls to its numbers stop reaching the agent immediately and the numbers are released.

DELETE
/v1/agents/voice/agents/{agent_id}/telephony/trunks/{trunk_id}

Authorization

personalAccessToken
AuthorizationBearer <token>

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

agent_id*string

Voice agent UUID.

trunk_id*string

SIP trunk UUID.

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/agents/voice/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/telephony/trunks/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "message": "string"
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Connect phone numbers

Provisions an inbound SIP trunk and a routing rule for the agent, and reserves the numbers. The agent must already be `deploying` or `deployed`. Numbers are normalized before validation — spaces, dashes, dots and brackets are stripped — and must carry a country code. They are unique across the platform, so connecting a number already attached elsewhere fails with `409`. `auth_password` is passed through to the routing layer and is not returned afterwards.

List calls

Every call the agent handled — web, phone, and WebSocket — most recently started first. Calls that were reserved but never connected are excluded.