Dynamiq
PlatformPython SDKAPI Reference
Voice Agents

Get telephony configuration

Returns the agent's SIP trunks, the phone numbers attached to them, the SIP URI to point your trunk's origination at, and per-provider setup steps.

GET
/v1/agents/voice/agents/{agent_id}/telephony

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.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agents/voice/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/telephony"
{
  "data": {
    "sip_uri": "string",
    "trunks": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "provider": "twilio",
        "status": "provisioning",
        "name": "string",
        "numbers": [
          "string"
        ],
        "livekit_trunk_id": "string",
        "auth_username": "string",
        "error": "string",
        "created_at": "2019-08-24T14:15:22Z"
      }
    ],
    "setup_instructions": {
      "property1": [
        "string"
      ],
      "property2": [
        "string"
      ]
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Test an MCP server

Probes an MCP server and lists the tools it exposes, so you can verify a server before attaching it to an agent. Backs the **Test connection** button in the builder. A failed probe is reported as `200` with `ok: false` and an `error` string — it is not an HTTP error. The response is **bare**, with no `data` envelope.

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.