Tone docs
API referenceCampaigns

Delete a campaign and its recipients

The calls it already placed survive in the call log — deleting the campaign must not erase the record of what was dialled.

Open in ClaudeOpen in ChatGPTView as Markdown

Requires the write scope. A key with less gets 403 insufficient_scope.

DELETE
/v1/campaigns/{id}

Authorization

AuthorizationBearer <token>

Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.

In: header

Path Parameters

id*string

The campaign's id.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/campaigns/string"
{  "data": null}
Was this page helpful?

Manually queue one settled recipient for another call. A completed campaign wakes up for it.

For the one number you want to try again after the run finished — a wrong time of day, a handset that was off. It respects the campaign calling window and the compliance gate like any other dial.

Resume a paused campaign

Picks up where it stopped, on the version of the agent it launched with. Top the wallet up first if it paused for low balance, or it will pause again.