Rotate a trunk's SIP password
const url = 'https://api.caller9.app/v1/trunks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rotate-password';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.caller9.app/v1/trunks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rotate-password \ --header 'Authorization: Bearer <token>'Generates a new SIP registration password. The PBX’s old credentials stop working at its next registration refresh or outbound call until it is reconfigured with the new password. Requires a full-access key.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”SIP trunk ID (UUID).
Responses
Section titled “Responses”The trunk with its new password.
object
A SIP trunk your PBX registers to. Includes registration credentials — sip_password is a secret; store it securely and never log it.
object
SIP registration username.
SIP registration password (secret). Changes when rotated.
The trunk’s SIP URI (sip:<username>@sip.telnyx.com).
ID of the organization number used as the default outbound caller ID.
Outbound caller ID name (CNAM); empty if unset.
Maximum concurrent calls; null = unlimited.
ISO 3166-1 alpha-2 country code (default US).
Numbers routed to this trunk for inbound calls, sorted by number.
object
E.164 phone number.
Example generated
{ "trunk": { "guid": "example", "organization_guid": "example", "name": "example", "sip_username": "example", "sip_password": "example", "sip_uri": "example", "default_cid_number_guid": "example", "cid_display_name": "example", "channel_limit": 1, "localization": "example", "numbers": [ { "guid": "example", "number": "example", "name": "example" } ], "created_at": "2026-04-15T12:00:00Z", "updated_at": "2026-04-15T12:00:00Z" }}Missing, invalid, expired or revoked API key.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}The key isn’t allowed to do this (e.g. a read-only key making a change).
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Not found, or belongs to another organization.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Too many requests for this API key. Retry after Retry-After seconds.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Headers
Section titled “Headers”Seconds until the rate-limit window resets.