Update Subscriber SIP Endpoint

PATCH 
/resources/subscribers/:fabric_subscriber_id/sip_endpoints/:id

Updates a Subscriber Sip Endpoint by ID

Request

Path Parameters

id uuidrequired

Unique ID of a Sip Endpoint.

fabric_subscriber_id uuidrequired

Unique ID of a Fabric Subscriber.

application/json

Body

required

oneOf

Update Subscriber SIP Endpoint with Call Handler

call_handlerCallHandlerPassthroughType (string)

Call handler of the Sip Endpoint.

Possible values: [default, passthrough, block-pstn]

usernamestring

Username of the Sip Endpoint.

Example: justice-league

passwordstring

Password of the Sip Endpoint.

Example: hack-me-if-you-can

password_confirmationstring

Confirmation of the Password

Example: hack-me-if-you-can

caller_idstring

Caller ID of the Sip Endpoint.

Example: call-id-123

send_asstring

The Number to send as.

Example: +14632322867

ciphersCipherType (string)[]

Ciphers of the Sip Endpoint.

Possible values: [AEAD_AES_256_GCM_8, AES_256_CM_HMAC_SHA1_80, AES_CM_128_HMAC_SHA1_80, AES_256_CM_HMAC_SHA1_32, AES_CM_128_HMAC_SHA1_32]

codecsCodecType (string)[]

Codecs of the Sip Endpoint.

Possible values: [OPUS, G722, PCMU, PCMA, G729, VP8, H264]

encryptionEncryptionType (string)

Encryption requirement of the Sip Endpoint.

Possible values: [default, required, optional]

Default value: default

Example: optional

Update Subscriber SIP Endpoint with Resource ID

calling_handler_resource_iduuid

Universal Unique Identifier.

usernamestring

Username of the Sip Endpoint.

Example: justice-league

passwordstring

Password of the Sip Endpoint.

Example: hack-me-if-you-can

password_confirmationstring

Confirmation of the Password

Example: hack-me-if-you-can

caller_idstring

Caller ID of the Sip Endpoint.

Example: call-id-123

send_asstring

The Number to send as.

Example: +14632322867

ciphersCipherType (string)[]

Ciphers of the Sip Endpoint.

Possible values: [AEAD_AES_256_GCM_8, AES_256_CM_HMAC_SHA1_80, AES_CM_128_HMAC_SHA1_80, AES_256_CM_HMAC_SHA1_32, AES_CM_128_HMAC_SHA1_32]

codecsCodecType (string)[]

Codecs of the Sip Endpoint.

Possible values: [OPUS, G722, PCMU, PCMA, G729, VP8, H264]

encryptionEncryptionType (string)

Encryption requirement of the Sip Endpoint.

Possible values: [default, required, optional]

Default value: default

Example: optional

Responses

200

The request has succeeded.

application/json

Schema

Schema

iduuidrequired

Universal Unique Identifier.

usernamestringrequired
Username of the Sip Endpoint.
Example: justice-league
caller_idstringrequired
Caller ID of the Sip Endpoint.
Example: call-id-123
send_asstringrequired
Purchased or verified number
Example: +14632322867
ciphersCipherType (string)[]required

Ciphers of the Sip Endpoint.

Possible values: [AEAD_AES_256_GCM_8, AES_256_CM_HMAC_SHA1_80, AES_CM_128_HMAC_SHA1_80, AES_256_CM_HMAC_SHA1_32, AES_CM_128_HMAC_SHA1_32]

codecsCodecType (string)[]required

Codecs of the Sip Endpoint.

Possible values: [OPUS, G722, PCMU, PCMA, G729, VP8, H264]

encryptionEncryptionType (string)required

Encryption

Possible values: [default, required, optional]

call_handlerCallHandlerType (string)required

Call handler of the Sip Endpoint.

Possible values: [default, passthrough, block-pstn, relay_script, laml_webhook, laml_application, dialogflow, relay_context, relay_connector, video_room, ai_agent, call_flow]

calling_handler_resource_iduuidrequired

Universal Unique Identifier.

Example (from schema)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "username": "justice-league",
  "caller_id": "call-id-123",
  "send_as": "+14632322867",
  "ciphers": [
    "AEAD_AES_256_GCM_8"
  ],
  "codecs": [
    "OPUS"
  ],
  "encryption": "default",
  "call_handler": "default",
  "calling_handler_resource_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

401

Access is unauthorized.

application/json

Schema

Schema

string

Possible values: [Unauthorized]

404

The server cannot find the requested resource.

application/json

Schema

Schema

string

Possible values: [Not Found]

422

Client error

application/json

Schema

Schema

errors

object[]

required

Array [

typestringrequired

Error type.

codestringrequired

Error code.

messagestringrequired

Error details.

attributestringrequired

Request parameter associated with this error.

urlstringrequired

Link to developer resource for this error.

]

Example (from schema)

{
  "errors": [
    {
      "type": "validation_error",
      "code": "invalid_parameter",
      "message": "Ciphers are invalid",
      "attribute": "ciphers",
      "url": "https://developer.signalwire.com/rest/signalwire-rest/overview/error-codes#invalid_parameter"
    }
  ]
}