Suggest Campaign Concepts

POST

/campaigns/suggest

• Production
• QA

Rank the top 15 campaign CONCEPTS from the playbook library for a goal.

Semantic search over the concept library plus rule-based scoring (fit, asset readiness, goal, channel feasibility). No generative model runs and nothing is created - POST /campaigns/generate-ideas is the generative, credit-spending counterpart. organization_id in the body is ignored.

Spends nothing.

Authorizations

• BearerAuth

Parameters

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

Generate campaign ideas from a goal. SPENDS CREDIT.

object

campaign_goal

required

string

campaign_type

Any of:

string

string

null

null

organization_id

Any of:

string

string

null

null

target_persona

Any of:

string

string

null

null

website_url

required

string

Responses

200

Successful Response

object

data

required

One Studio object, open-shaped. See the module docstring.

object

key

additional properties

any

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string