Update enabled Voice destination countries
/v1/voice/destinationsconst destinations = await bird.voice.destinations.update({
destinations: [{ country_code: "PT", enabled: true }],
});
console.log(destinations.data?.length ?? 0);destinations = client.voice.destinations.update(
destinations=[{"country_code": "PT", "enabled": True}]
)
print(len(destinations.data))destinations, err := client.Voice.Destinations.Update(context.Background(), bird.VoiceDestinationsUpdateParams{
Destinations: []bird.DestinationSetting{{CountryCode: "PT", Enabled: bird.Bool(true)}},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(len(destinations.Data))$destinations = $bird->voice->destinations->update(
(new VoiceDestinationsUpdate())->setDestinations([
(new DestinationSetting())->setCountryCode('PT')->setEnabled(true),
]),
);
echo count($destinations->getData() ?? []), "\n";bird voice destinations update --body-file - <<'JSON'
{
"destinations": [
{
"country_code": "NL",
"enabled": true
},
{
"country_code": "GB",
"enabled": false
}
]
}
JSONcurl -X PATCH "https://us1.platform.bird.com/v1/voice/destinations" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"destinations": [
{
"country_code": "NL",
"enabled": true
},
{
"country_code": "GB",
"enabled": false
}
]
}'{
"data": [
{
"country_code": "US",
"country_name": "Netherlands",
"dial_code": "31",
"region": "western_europe",
"super_region": "europe",
"status": "available",
"daily_spend_limit": {
"limit": {
"amount": "0.00995",
"currency_code": "USD"
},
"used": {
"amount": "0.00995",
"currency_code": "USD"
},
"remaining": {
"amount": "0.00995",
"currency_code": "USD"
},
"resets_at": "2026-10-09T00:00:00Z"
}
}
]
}
Enables or disables specific destination countries for your workspace, and sets or removes their daily spend limits. Only the countries listed in the request change; any country you do not list keeps its current setting. Each code must be a country the Voice service supports, or the request is rejected and nothing changes; removing a daily spend limit is the exception and accepts any country code. A daily spend limit caps what your workspace spends on calls to a country each day, whether or not it is enabled.
Anfrage-Nutzlast
destinationsThe destination countries to change. Only the countries listed here change, and only the fields you send; anything else keeps its current setting. A country listed more than once takes its last enabled, but may set or remove daily_spend_limit only once. A limit can be set only on a country the Voice service supports; removing one accepts any country code. Otherwise the request is rejected and nothing changes.
Antwort-Payload
dataThe Voice destination countries, each annotated with your workspace's enabled setting.
Untergeordnete Attribute anzeigen
data.country_codeISO 3166-1 alpha-2 country code.
data.country_nameFull English country name.
data.dial_codeInternational dialling prefix, without the leading plus. Absent for countries that have none.
data.regionThe commercial region this country belongs to, for grouping a destination list the way it is bought rather than alphabetically. null for a country we have not assigned yet. Bird defines these regions independently of ISO and UN M49. A country can move between them, so treat the set as open.
Possible values (may grow over time): western_europe, nordics_baltics, southern_europe, central_eastern_europe, north_america, latin_america_caribbean, middle_east_north_africa, sub_saharan_africa, central_asia_caucasus, south_asia, south_east_asia, east_asia, oceania
data.super_regionThe continent-scale group the region rolls up into. Derived from region, and null whenever that is. Treat the set as open.
Possible values (may grow over time): europe, americas, middle_east_africa, asia_pacific
data.enabledWhether your workspace has enabled calling to this country.
data.statusThis country's Voice callability at the destination level, independent of your enabled setting. available means we place calls there; not_supported means we do not.
Possible values (may grow over time): available, not_supported
data.high_risk_destinationWhether we treat this country as a high-risk calling destination.
data.daily_spend_limitYour workspace's daily spend limit for calls to this country and today's usage toward it. It applies whether or not the country is enabled, including to verification calls. Null when you have not set one, before your organization has a wallet, or while your wallet currency cannot be read; a limit you set is still enforced then.
Untergeordnete Attribute anzeigen
data.daily_spend_limit.limitThe most your workspace can spend on calls to this country each day, in your organization's wallet currency. Calls are also held to the workspace's own daily limit, and whichever is reached first refuses the call.
Untergeordnete Attribute anzeigen
data.daily_spend_limit.limit.amountDecimal amount as a string, in major currency units.
data.daily_spend_limit.limit.currency_codeISO 4217 currency code.
data.daily_spend_limit.usedUsed toward today's limit for this country, including calls in progress. A call counts its expected cost when it starts; the part it did not use returns when it is billed. Null when today's usage cannot be read right now; the limit is still enforced.
data.daily_spend_limit.remainingWhat is left of this country's limit today, never below zero. Null when today's usage cannot be read.
data.daily_spend_limit.resets_atWhen usage resets to zero, at midnight UTC.
totalTotal number of destination countries.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.