Replace a campaign's disposition buttons
Replaces the campaign’s whole disposition-button set — the buttons an agent picks from to close a call. Each button references a call tag by tag_id (list them with the disposition-tags call) and declares the outcome_kind that tells the dialer what to do next (retry, reschedule, stop calling, …). An empty buttons array clears the set.
The button’s display name and colour are always taken from the referenced tag, so a color key in the body is rejected with 400 rather than silently ignored. Referencing the same tag twice returns 409, and an unknown outcome_kind returns 422.
Authorizations
HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).
Path Parameters
Dialer campaign ID.
^[1-9][0-9]*$Body
Replace-all body for a campaign's disposition buttons. A color key on a button is rejected with 400 — presentation always comes from the referenced tag.
The complete button set for the campaign. An empty array clears every button.
Response
The campaign's disposition buttons after the replace, ordered by display_order.
Button ID.
"15"
Referenced call-tag ID.
"101"
How the dialer treats a call dispositioned with this button.
successful_positive, successful_negative, rescheduled, unsuccessful_call_again, unsuccessful_do_not_call "rescheduled"
Colour of the referenced tag; null when unresolvable.
"#FFAA00"
Ascending display position.
0
Display name of the referenced tag; null when unresolvable.
"Call back later"
Outcome of the referenced tag; null when unresolvable.
"rescheduled"
Related topics
Get a campaign's disposition buttonsList disposition tagsCloudTalk REST API: Call Center Automation Platform