Skip to navigation
Resource ManagementSIP Addresses

Update SIP address

View as MarkdownOpen in Claude

Partially updates a standalone SIP Address by ID; omitted fields retain their current values. Use it to change the URI name, Domain, registration password, media, encryption, or IP-authentication settings. calling_handler_resource_id cannot be changed through this operation. SIP Credentials and generic resource addresses have separate management endpoints.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Calling, Fax, Messaging, or Video.

Learn more about API scopes.

Authentication

AuthorizationBasic

SignalWire Basic Authentication using Project ID and API Token.

The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password.

Example:

Authorization: Basic base64(project_id:token)

Path parameters

idstringRequiredformat: "uuid"
Unique ID of a SIP Address.

Request

This endpoint expects an object.
namestringOptionalformat: "^[a-z0-9]+(-[a-z0-9]+)*$"<=50 characters

URL-safe name for the SIP address — lowercase letters, numbers, and hyphens only (no spaces or other special characters). Must be unique within the project. Defaults to the current value when omitted.

userstringOptionalformat: "^\S+$"

SIP username used to reach this address (no spaces). Together with the address’s Domain, must be unique across your SignalWire account.

context_idstringOptionalformat: "uuid"
ID of the Domain this address should be grouped under. Must exist in your project. Defaults to the address's current Domain when omitted.
ip_auth_enabledbooleanOptional
Whether to enforce IP authentication for this address.
ip_authlist of stringsOptional

Whitelisted IP/CIDR entries. Required (at least one) when ip_auth_enabled is true. Maximum 256 entries.

codecslist of enumsOptional

Non-empty subset of enabled codecs.

cipherslist of enumsOptional

Non-empty subset of enabled SRTP ciphers.

Allowed values:
encryptionenumOptional
SRTP encryption requirement for calls to this address.
Allowed values:
passwordstringOptional

Write-only SIP registration password. Never returned in any response.

Response

The request has succeeded.
idstringformat: "uuid"
Unique identifier for the SIP address.
typeenum

The object type. Always sip.

Allowed values:
resource_idstringformat: "uuid"
ID of the resource this address belongs to.
namestring

URL-safe name for the SIP address. Used to build its SIP URI.

display_namestring

Human-friendly label for the SIP address. Defaults to name.

contextstring

The Domain this address is grouped under — for example, public for your project’s default Domain.

uristring
Full SIP URI for this address.
userstring

SIP username used to reach this address. * accepts any username.

encryptionenum
SRTP encryption requirement for calls to this address.
Allowed values:
codecslist of enums
Enabled codecs for calls to this address.
cipherslist of enums
Enabled SRTP ciphers for calls to this address.
Allowed values:
ip_auth_enabledboolean
Whether IP authentication is enforced for this address.
ip_authlist of strings

Whitelisted IP/CIDR entries used when ip_auth_enabled is true.

calling_handler_resource_idstringformat: "uuid"
ID of the resource that handles inbound calls to this address.
created_atdatetime
Date and time when the SIP address was created.
updated_atdatetime
Date and time when the SIP address was last updated.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error