Archive a campaign

Overview

Take one campaign out of the list, the same as Archive in the workspace. Refused while a payment is in progress or any of its work is paid or booked (conflict, has_committed_work). Archiving an archived campaign returns when it was archived. An archived campaign still reads in campaign_status with archived_at set and stage Archived; renaming it or setting its guidelines is refused. Needs an idempotency_key.

Server

https://app.distribution.tech/api/mcp

Scope

campaigns:write

Changes data

Yes, pass an idempotency_key

REST endpoint

POST /campaigns/{id}/archive

Arguments

Call with curl

The server speaks streamable HTTP, so one JSON-RPC tools/call request runs the tool. Set DISTRIBUTION_API_KEY to a key from Developers with the campaigns:write scope; the arguments shown are the required ones.

curl -X POST "https://app.distribution.tech/api/mcp" \
  -H "Authorization: Bearer $DISTRIBUTION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "archive_campaign",
    "arguments": {
      "idempotency_key": "<string>",
      "campaign_id": "<uuid>"
    }
  }
}'

Result

The answer's structuredContent follows the tool's output schema (the same JSON is in its text content). It has these fields:

{
  "campaign_id": "<uuid>",
  "archived_at": "<date-time>"
}

Other tools

• inventory: Network coverage
• resolve_audience: Resolve an audience
• campaign_status: Campaign status
• evidence: Proof of delivery
• results: Results
• brain_get: Company context
• creators_search: Find creators
• creator_get: One creator
• creator_ask_price: Ask for a price
• plan_quote: Quote a plan
• create_campaign: Start a campaign
• plan_add_creator: Add a creator
• plan_remove_creator: Remove a creator
• plan_move_dates: Move a plan's dates
• plan_swap_creator: Swap a creator
• set_creator_guidelines: Set the creator guidelines
• approve_plan: Approve and get the pay link
• rename_campaign: Rename a campaign
• delete_campaign: Delete a draft campaign
• feedback_send: Send feedback
• feedback_list: Your feedback

Get access

Keys are created in Developers once your brand is approved. Connect an agent to ask for access, then read the agent guide for the full flow.