Strategy / REST API

Create strategy ideas

Run the Strategist diverge pass: brainstorm and curate campaign ideas (hook angle, archetype, personalization elements, CTA, proof point, differentiation, estimated audience) for your workspace. Same canonical engine the in-app Strategist uses, so the output matches the UI. Pass guidance when the operator has a specific ICP, offer, signal source, competitor post, or playbook direction. Returns { agentRunId, ideas }. Pick the strongest idea id and pass it to create-campaign-brief.

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

Parameters

workspaceIdOptional · string: Optional with an API key (inferred from the key).
ideaCountOptional · number: How many curated winner ideas to return (1-10, default 5).
guidanceOptional · string: Optional operator guidance to steer the brainstorm, such as ICP, offer, signal source, competitor post URL, or playbook direction.
allowHostedAiOptional · boolean: Must be true when this operation uses Pipeline hosted inference.

Request example

curl -X POST "https://app.pipeline.help/api/v1/strategy/ideas" \
  -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)."
    },
    "ideaCount": {
      "type": "number",
      "description": "How many curated winner ideas to return (1-10, default 5)."
    },
    "guidance": {
      "type": "string",
      "description": "Optional operator guidance to steer the brainstorm, such as ICP, offer, signal source, competitor post URL, or playbook direction."
    },
    "allowHostedAi": {
      "type": "boolean",
      "description": "Must be true when this operation uses Pipeline hosted inference."
    }
  }
}

See this operation inCLI MCP TypeScript SDK