Change the voice settings
put/calls/settings
Change the voice settings. Recording cannot be turned on until the project confirms its counsel has read the recording rules.
Before you call
- Credential
Authorization: Bearer $KEY- Scope
voice:write- Graphql
Mutation.voiceCallSettingsUpdate- Sdk
calls.settings.update- Cli
calls settings-set
Request bodyapplication/json, required
- callerIdslist of string
- recordingobject
- enabledbooleanOff unless turned on. Cannot be on until counselReviewed is true
- counselReviewedbooleanYour counsel has read the recording rules for the places your callers are in
- retentionDaysintegerAt least 1. At most 365.
- enabledboolean
- allowCountrieslist of string
- denyCountrieslist of string
- blockPremiumboolean
- maxCallsPerHourintegerAt least 1. At most 10000.
- maxSecondsPerCallintegerAt least 30. At most 3600.
- callerNamestring or nullThe name every call opens with: This is an automated call from ...
- quietHoursobject or null
Responses
- 200application/jsonSuccess
- 400application/jsonThe request was malformed
- errorstringrequired
- messagestring
- 401application/jsonNo valid credential
- errorstringrequired
- messagestring
- 403application/jsonThe credential lacks the scope, origin or address
- errorstringrequired
- messagestring
- 429application/jsonOver the key's rate limit; see Retry-After
- errorstringrequired
- messagestring