RankSharkDocs
Campaigns

Delete a campaign and erase its data (irreversible)

RankShark EnhanceScopecampaigns:delete

DELETE
/api/v1/campaigns/{id}

Deleting is permanent and cannot be undone: the campaign is stopped and deleted, and its visits, statistics, daily totals, sessions, log lines and report screenshots are erased (dashboard totals no longer include it). To keep a campaign's history, archive it instead. Scope campaigns:delete; at most 10 a minute.

Authorization

headerAuthorizationBearer <token>

An Enhance API key (rsen_…) or an OAuth 2.1 access token, as "Authorization: Bearer …".

Path Parameters

id*string

Campaign id

Response Body

Deleted

application/json
  1. response
deleted*string

The id, or "all"

erased?boolean

Its data was erased too

Example Request
curl -X DELETE 'https://panel.rankshark.io/api/v1/campaigns/string'
Example Response
{  "deleted": "string",  "erased": true}

Create a campaign POST

Send {"spec": CampaignSpec} (the input contract, GET /api/v1/schema/spec) or a full campaign document. Validate first with the same body and the MCP tool enhance_validate_campaign, or check a workflow with POST /api/v1/flows/validate. The new campaign is not started: POST /api/v1/campaigns/start.

Delete every campaign and erase their data (irreversible) DELETE

Deleting is permanent and cannot be undone: the campaign is stopped and deleted, and its visits, statistics, daily totals, sessions, log lines and report screenshots are erased (dashboard totals no longer include it). To keep a campaign's history, archive it instead. Deletes every campaign that is not archived; requires ?confirm=DELETE_ALL. Scope campaigns:delete; at most 10 a minute.