Promote the secondary Auth Token to primary

POST /v1/AuthTokens/Promote

Auth Token promotion

Promote the secondary Auth Token to primary. After promoting the new token, all requests to Twilio using your old primary Auth Token will result in an error.

Responses

  • 200

    OK

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that the secondary Auth Token was created for

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • auth_token string | null

      The promoted Auth Token

    • date_created string(date-time) | null

      The ISO 8601 formatted date and time in UTC when the resource was created

    • date_updated string(date-time) | null

      The ISO 8601 formatted date and time in UTC when the resource was last updated

    • url string(uri) | null

      The URI for this resource, relative to https://accounts.twilio.com
POST /v1/AuthTokens/Promote 
curl \
 -X POST https://accounts.twilio.com/v1/AuthTokens/Promote \
 --user "username:password"
Response examples (200) 
{
  "account_sid": "string",
  "auth_token": "string",
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "url": "https://example.com"
}
Response examples (200) 
{
  "account_sid": "string",
  "auth_token": "string",
  "date_created": "2025-05-04T09:42:00Z",
  "date_updated": "2025-05-04T09:42:00Z",
  "url": "https://example.com"
}