Skip to main content
PUT
/
api
/
v1
/
providers
/
twilio
/
{id}
Update Twilio provider
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>', region: '<string>', supportsCallTransfer: true})
};

fetch('https://blackbox.dasha.ai/api/v1/providers/twilio/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "name": "<string>",
  "providerType": "twilio",
  "accountSid": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "lastVerifiedAt": "2023-11-07T05:31:56Z",
  "phoneNumberCount": 123,
  "verificationDetails": [
    {
      "checkName": "<string>",
      "message": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "details": {}
    }
  ],
  "trunkSid": "<string>",
  "terminationUri": "<string>",
  "region": "<string>",
  "supportsCallTransfer": true
}

​
Updatable Fields

The following fields can be updated:
FieldDescription
nameDisplay name for the provider
regionTwilio region for SIP trunk (us1, us2, ie1, de1, etc.)
supportsCallTransferEnable/disable call transfer support

​
Credential Updates

For security reasons, Account SID and Auth Token cannot be updated. If you need to change credentials:
  1. Create a new provider with the new credentials
  2. Import phone numbers to the new provider
  3. Delete the old provider

​
Partial Updates

This endpoint supports partial updates. Only include the fields you want to change in the request body.

Path Parameters

​
id
string<uuid>
required

Provider identifier

Body

Fields to update (only provided fields are modified)

Request DTO for updating an existing Twilio provider integration. All fields are optional and only provided fields will be updated. Credentials (AccountSid, AuthToken) cannot be updated through this endpoint for security reasons - create a new provider integration if credentials need to be changed.

​
name
string | null

Display name for the provider integration. Used to identify the provider in the UI and API responses.

Maximum string length: 100
​
region
string | null

Twilio region for SIP trunk configuration. Affects call routing latency and regional compliance. Common values: us1, us2, ie1, de1, au1, jp1, br1, sg1.

​
supportsCallTransfer
boolean | null

Whether to enable call transfer support. When enabled, allows warm and cold transfers during calls. Requires proper Twilio account configuration and sufficient permissions.

Response

Twilio provider updated successfully

Response DTO for Twilio provider integrations. Contains Twilio-specific configuration details including account identifier, SIP trunk configuration, and regional settings. AuthToken is intentionally excluded from responses for security.

​
name
string | null
required

Display name for the provider integration. Used to identify the provider in the UI and API responses.

​
providerType
enum<string>
required

Type of VoIP provider. Always returns Twilio for this DTO.

Available options:
twilio
​
accountSid
string
required

Twilio Account SID. A unique identifier for the Twilio account associated with this provider. Format: AC[a-f0-9]{32} (e.g., ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx).

Minimum string length: 1
​
id
string<uuid>

Unique identifier for the provider integration.

​
verificationStatus
enum<string>

Current verification status of the provider credentials. Indicates the health and validity of the integration. Supported values: pending, verified, warning, failed.

Available options:
pending,
verified,
warning,
failed
​
lastVerifiedAt
string<date-time> | null

Timestamp when the provider credentials were last verified. Null if verification has never been performed.

​
phoneNumberCount
integer<int32>

Total number of phone numbers currently imported and managed through this provider integration.

​
verificationDetails
object[] | null

Detailed results of the last verification. Contains individual check results with status, messages, and timestamps. Null if verification has never been performed.

​
trunkSid
string | null

Twilio SIP Trunk SID. The unique identifier for the SIP trunk created in Twilio for this provider. Format: TK[a-f0-9]{32} (e.g., TKxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx).

​
terminationUri
string | null

SIP trunk termination URI configured for this provider. Used for routing outbound calls through Twilio. Format: sip:.pstn.twilio.com

​
region
string | null

Twilio region where the SIP trunk is configured. Affects call routing latency and regional compliance. Common values: us1, us2, ie1, de1, au1, jp1, br1, sg1.

​
supportsCallTransfer
boolean

Whether the provider supports call transfers. When enabled, allows warm and cold transfers during calls. Requires proper Twilio account configuration and sufficient permissions.