Skip to content
Vocapable Developers

Make a verified telephony account the default for future account-omitted calls

PUT
/v1/telephony-accounts/{account_id}/default
curl --request PUT \
  --url https://api.vocapable.com/v1/telephony-accounts/example/default \
  --header 'Authorization: Bearer <token>'

Move only the tenant fallback; existing campaigns keep their elected account.

This is intentionally explicit rather than a side effect of connecting a later BYO account. It lets a sandbox customer use the managed verified-number test lane first, then choose verified BYO Twilio as the production fallback without silently rerouting any campaign that already named an account.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
account_id
required
Account Id
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
TelephonyAccountSummary

An account as its tenant sees it - credential material is structurally absent.

object
id
required
Id
string
mode
required
Mode
string
Allowed values: byo managed
provider
required
Provider
string
credentials_stored
required
Credentials Stored
boolean
cps_limit
Any of:
integer
a2p_brand_ref
Any of:
string
ftc_san_refs
Ftc San Refs
Array<object>
FtcSanRef

One FTC Subscription Account Number and the area codes it covers (CANON fact 5).

object
san
required
San
string
area_codes
Area Codes
Array<string>
verification_status
required
Verification Status
string
Allowed values: pending verifying mock_verified verified failed suspended
verified_at
Any of:
string format: date-time
telephony_minutes_metered
required
Telephony Minutes Metered
boolean
created_at
required
Created At
string format: date-time
Example
{
  "mode": "byo",
  "verification_status": "pending"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}