Skip to main content
POST
Generate Prompt Suggestions

Authorizations

X-API-Key
string
header
required

Body

topic_id
string

Generates for this topic alone instead of every topic awaiting review, replacing the suggestions it already has.

Minimum string length: 1
Example:

"to_e6b8cdd3-a51b-4d94-a866-28dbe6b830a6"

prompt_suggestion_id
string

Replaces this one Prompt Builder suggestion, keeping its id, topic and market.

Minimum string length: 1
Example:

"pr_93f790de-5b7a-45ee-b782-61103c81f20d"

segment
object

Adds suggestions for one slice of a topic, keeping the suggestions it already has. Any dimension left unset is filled from the project's target distribution and markets.

Response

Generation queued

Generation queued

generation_id
string<uuid>
required

The generation to poll with GET /prompts/suggestions/generations/{generation_id}.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
topic_id
string

The topic being generated when the request scoped the run to one topic or suggestion.