Skip to main content

UpdateDID modifies an existing DID.

PATCH 
/api/v1/voice/dids/:id

Updates DID routing configuration and status. DIDs can route to flows, queues, agents, or external numbers.

Parameters​

  • id: Required, DID to update
  • description: Optional, human-readable description
  • destination: Optional, primary routing destination
  • fallback_destination: Optional, fallback if primary fails
  • status: Optional, new status (active, inactive, ported)

Destination Types​

  • flow: Route to IVR flow (data: {id: flow_id})
  • queue: Route to queue (data: {id: queue_id})
  • agent: Route to agent (data: {id: agent_id})
  • external: Route to external number (data: {number: "+1..."})

Errors​

  • NOT_FOUND: DID does not exist
  • INVALID_ARGUMENT: Invalid destination type or data
  • PERMISSION_DENIED: Caller lacks voice:did:write permission

Request​

Responses​

A successful response.