Skip to main content
PATCH
Update inbound routing of a custom SIP domain

Path Parameters

id
string<uuid>
required

Domain identifier

Body

Routing settings

Inbound routing settings of a custom SIP domain.

defaultAgentId
string | null

Agent that answers every inbound call on the domain whose SIP user part is not a registered call id. Null rejects such calls. The agent must belong to your organization.

Response

Routing updated

Custom SIP domain with its verification state and the DNS records to publish.

id
string<uuid>
required

Unique identifier of the domain record. Pass it as sipDomainId when registering a call.

orgId
string
required

Organization that owns the domain.

Minimum string length: 1
domain
string
required

Normalized hostname.

Minimum string length: 1
status
enum<string>
required

PendingVerification until the TXT record is found and the platform registration succeeds; Active when usable; Failed when the platform refused the domain.

Available options:
PendingVerification,
Active,
Failed
createdTime
string<date-time>
required

Timestamp when the domain was added.

lastUpdateTime
string<date-time>
required

Timestamp of the last change.

exampleSipUri
string
required

Example of the SIP URI registered calls will get on this domain.

Minimum string length: 1
dns
object
required

DNS records to publish for verification and routing.

lastError
string | null

Reason for the last failed verification or registration attempt, if any.

verifiedTime
string<date-time> | null

When the domain became Active.

defaultAgentId
string | null

Agent that answers inbound calls on this domain whose SIP user part is not a registered call id. Null means such calls are rejected with SIP 404.

defaultAgentName
string | null

Display name of the default agent, when set.

routingRecordsDetected
boolean | null

Result of the last routing DNS check: true when the domain already resolves to the Dasha SIP host (CNAME or copied A records). Only set by the verify endpoint.