Strategy / REST API

Create campaign brief

Expand a chosen idea into a full structured campaign brief (ICP rubric, targeting filters, required research signals, message decision tree, frameworks, cadence). For kind=campaign pass the ideaId from create-strategy-ideas. kind=content or engagement build single-shot from workspace context (no ideaId). The brief persists as draft; run activate-brief to launch it. Returns { agentRunId, brief, kind }.

POST /api/v1/strategy/briefBackend AI, consent required

Parameters

workspaceIdOptional · string: Optional with an API key (inferred from the key).
kindOptional · string: Brief kind. Default campaign.campaign · content · engagement
ideaIdOptional · string: Required when kind=campaign: the campaign idea to expand.
allowHostedAiOptional · boolean: Must be true when this operation uses Pipeline hosted inference.

Request example

curl -X POST "https://app.pipeline.help/api/v1/strategy/brief" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "X-Pipeline-Execution-Policy: hosted-enabled" \
  -H "Content-Type: application/json" \
  -d '{"allowHostedAi":true}'

Full input schema

Input schema

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Optional with an API key (inferred from the key)."
    },
    "kind": {
      "type": "string",
      "enum": [
        "campaign",
        "content",
        "engagement"
      ],
      "description": "Brief kind. Default campaign."
    },
    "ideaId": {
      "type": "string",
      "description": "Required when kind=campaign: the campaign idea to expand."
    },
    "allowHostedAi": {
      "type": "boolean",
      "description": "Must be true when this operation uses Pipeline hosted inference."
    }
  }
}

See this operation inCLI MCP TypeScript SDK