Skip to main content
POST
Add prompts to a topic cluster
Add AI prompts (questions people ask AI tools) to a topic cluster. SnowSEO will monitor how often your brand appears in AI-generated answers for these prompts.
Newly added prompts are analyzed automatically in the background. It may take a few minutes before AI visibility data appears for new prompts.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

topicId
string
required

Topic cluster ID

Body

application/json
teamId
string
prompts
object[]

Each item is either { promptId } to link an existing prompt or { prompt, intent, region? } to create a new one. region is the structured country-level object { type, city, state, country, iso2, iso3 }; omit for worldwide.

intents
object

Map of prompt text → intent override

track
boolean

Whether to enable tracking on newly linked prompts

Response

Default Response

success
boolean
required
linked
number
required
created
number
required
promptIds
string[]
required
skipped
number
promptsSkipped
number
alreadyLinked
number