Delete a planned campaign
DELETE/recertification/campaigns/:campaignID
Deletes a campaign. The campaign must satisfy all of the following:
- Status is
PLANNED - No group has
reviewedStatusset - No group has
usersReviewed > 0
Roles: CAMPAIGN_ADMIN/CAMPAIGN_MANAGER or CAMPAIGN_DELETE.
Scope: cidaas:campaign_delete.
Emits fact event RECERTIFICATION_CAMPAIGN_DELETED.
Request
Responses
- 204
- 400
- 401
- 403
- 404
- 409
Campaign deleted successfully (no body)
Invalid payload, validation failure, or business rule violation
Missing/invalid token or insufficient reviewer role
Token valid but role/scope insufficient
Campaign ID not found
Campaign exists but cannot be deleted. Two possible reasons:
- Campaign is
IN_PROGRESSorCOMPLETED— onlyPLANNEDcampaigns can be deleted. - Campaign is
PLANNEDbut reviews have already started — deletion is not allowed once any reviewer has submitted a decision.