Outbound Trunk Regenerate Credentials#

Regenerates the username and password for an outbound trunk that uses the credentials_and_ip authentication method.

Note

  • The endpoint is relevant only for trunks that use credentials_and_ip authentication.

  • POST /v3/voice_out_trunk_regenerate_credentials is available in version 2026-11-19 to customers with the Outbound API enabled, even if they do not have the Outbound feature enabled. Without the Outbound API, the request returns 403 Forbidden.

Request#

HTTP Method: POST

URI Path: /v3/voice_out_trunk_regenerate_credentials

Request Body Relationships#

Name

Type

Description

voice_out_trunk

Outbound Trunk Object

The outbound trunk whose credentials should be regenerated.

Example#

http

 1POST /v3/voice_out_trunk_regenerate_credentials HTTP/1.1
 2Host: api.didww.com
 3Content-Type: application/vnd.api+json
 4Accept: application/vnd.api+json
 5Authorization: Bearer [access token]
 6
 7{
 8  "data": {
 9    "type": "voice_out_trunk_regenerate_credentials",
10    "relationships": {
11      "voice_out_trunk": {
12        "data": {
13          "id": "457bf47d-446d-41cd-91c3-dfbda7bf0753",
14          "type": "voice_out_trunks"
15        }
16      }
17    }
18  }
19}

curl

1curl -i -X POST https://api.didww.com/v3/voice_out_trunk_regenerate_credentials -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]" --data-raw '{"data": {"relationships": {"voice_out_trunk": {"data": {"id": "457bf47d-446d-41cd-91c3-dfbda7bf0753", "type": "voice_out_trunks"}}}, "type": "voice_out_trunk_regenerate_credentials"}}'

response

 1HTTP/1.1 201 Created
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "457bf47d-446d-41cd-91c3-dfbda7bf0753",
 7    "type": "voice_out_trunk_regenerate_credentials"
 8  },
 9  "meta": {
10    "api_version": "2026-11-19"
11  }
12}

Other Responses#

Code

Success

Description

404

No

Not Found. The trunk uses twilio authentication.

422

No

Validation Error Object. The trunk is unknown or uses ip_only authentication.

400

No

Bad Request. The body carries a member the API does not accept.

401

No

Unauthorized

403

No

The Outbound API is not enabled for the account. Also returned when the access token carries the read scope, which does not cover this method (title Insufficient scope, WWW-Authenticate: Bearer error="insufficient_scope"). See Scopes.

429

No

The request budget of the account for the current window is spent (too_many_requests). Retry-After gives the number of seconds to wait.