Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiHosted AI, explicit consent

Create strategy ideas

POST /api/v1/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.

Parameters

workspaceId

string

Optional with an API key (inferred from the key).

ideaCount

number

How many curated winner ideas to return (1-10, default 5).

guidance

string

Optional operator guidance to steer the brainstorm, such as ICP, offer, signal source, competitor post URL, or playbook direction.

allowHostedAi

boolean

Must be true when this operation uses Pipeline hosted inference.

Example

REST requestbash

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}'

Response

The operation is available, but its typed response schema has not been published yet.

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.