Delete a Campaign Plan
Deletes a Campaign Plan and its Line Items. Send the base_revision you read. The slug becomes free again.
AdCrunch keeps the record of what those lines already created. Those provider objects are live in an ad account, and the deletion of a planning row does not remove them.
The answer is 409 with error=revision_mismatch if the Campaign Plan changed after you read it.
/context/campaign-plans/{slug}AuthorizationBearer token · headerrequiredSend Authorization: Bearer <credential>.
Use an API key (acr_…), from the AdCrunch console under Settings → API keys.
The credential names the organization, and no operation takes an organization parameter.
See https://docs.adcrunch.dev/api/authentication.
slugstringrequiredbase_revisionintegerrequiredDeleted, with its Line Items. What those lines already created is kept: those provider objects are live in somebody’s ad account and were never ours to withdraw.
The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. error is invalid_request, and issues names each field. Nothing was changed.
issuesobject[]requiredOne entry for each field that does not match.
Show propertiesHide properties
objectinstringrequiredThe part of the request that holds the field.
bodycookieheadersparamsquerymessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
pathstringrequiredA JSON Pointer into that part of the request, such as /filename. An empty string is the whole part.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
invalid_requestmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
No API key, or one that does not resolve. See the security scheme. error is unauthorized.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
unauthorizedmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
The caller does not hold campaign_plan:write. error is forbidden.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
forbiddenmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
No Campaign Plan with that slug. error is not_found.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
messagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
The plan moved since you read it. error is revision_mismatch. Adding or deleting a Line Item moves an approved plan, because it takes the approval away. Re-read the Campaign Plan before you delete it.
currentRevisionnumberrequiredThe revision the row holds now. Re-read, re-apply your edit on top, and send this back as base_revision.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
revision_mismatchmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.