Rename a campaign

Overview

Give one campaign a new name, the same as Rename in the workspace. A new campaign is named "<company>, <Goal>, <Month>" until it is renamed; the name is what the workspace, the emails and campaign_status show. 1 to 80 characters, spaces collapsed. Any live campaign of the brand's can be renamed, paid or not; an archived one is refused (conflict, archived) until it is restored in the workspace. Needs an idempotency_key. Within the key's mandate; recorded as an agent run.

Server

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

Scope

campaigns:write

Changes data

Yes, pass an idempotency_key

REST endpoint

PATCH /campaigns/{id}

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": "rename_campaign",
    "arguments": {
      "idempotency_key": "<string>",
      "campaign_id": "<uuid>",
      "name": "<string>"
    }
  }
}'

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>",
  "name": "<string>"
}

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
• archive_campaign: Archive 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.