Skip to main content
PATCH
/
v1
/
sip-trunks
/
assignments
/
{assignmentId}
Update SIP trunk assignment
curl --request PATCH \
  --url https://api.vatel.ai/v1/sip-trunks/assignments/{assignmentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "<string>",
  "alternate_number": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sip_trunk_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "number": "<string>",
  "alternate_number": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Send your organization API key as Authorization: Bearer <key>.

Path Parameters

​
assignmentId
string<uuid>
required

Assignment id

Body

application/json

Patch only fields present in the JSON. Use null to clear number or alternate_number.

​
number
string | null

Digest-auth routing number (unique per trunk); null clears.

​
alternate_number
string | null

ACL routing alternate dial string (globally unique); null clears.

Response

Updated assignment

Binds an org agent to a SIP trunk. With digest inbound auth, routing uses number. With ACL inbound auth, routing uses alternate_number (globally unique).

​
id
string<uuid>
​
agent_id
string<uuid>
​
sip_trunk_id
string<uuid>
​
number
string

Number to dial for this agent when the trunk uses digest inbound auth; must be unique among assignments on this trunk.

​
alternate_number
string

Globally unique alternate dial string when the trunk uses ACL inbound auth; used instead of per-trunk number routing in that mode.

​
created_at
string<date-time>