Create Prompt
Creates a new prompt with variants for the specified platforms. Requires the configure scope.
Behavior:
stageis optional. If omitted, the journey stage is auto-classified against your brand’s active stages using an LLM.- If
stageis provided, it must match one of your brand’s active stages (case-sensitive display name). An unknown value returns400. An explicit stage is treated as a manual assertion and won’t be overwritten by later re-classification. - Creates variants for each specified platform.
- Reactivates an archived prompt if a duplicate exists.
- Dispatches collection events to begin tracking.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier for the brand
Body
Input model for creating a new prompt to track AI visibility.
The prompt text to track across AI platforms
Optional persona ID to associate with this prompt for segmented analysis
The customer journey stage this prompt represents. Must match one of your brand's active stages (case-sensitive display name); custom stage names are accepted. Omit to auto-classify against the brand's stage definitions.
Default stage sets:
- Intent (v1) —
Advice,Awareness,Evaluation,Comparison,Other - Funnel (v2) —
Awareness,Consideration,Conversion,Loyalty,Other
Unknown stage names return 400 Bad Request. An explicit stage is treated as a manual selection and won't be reclassified later.
Custom tags for categorizing and filtering prompts
Key topics to associate with this prompt from the brand's topic list
Lowercase ISO 639-1 code of the language the prompt text is written in (e.g. pt, ja, es). Case-insensitive; uppercase input is normalized. Invalid codes return 422 Unprocessable Entity. If omitted, the language is auto-detected from the prompt text, falling back to the brand's default language.
AI platforms to track this prompt on. If empty, defaults to all supported platforms.
Supported platforms:
chatgpt- OpenAI ChatGPTclaude- Anthropic Claudegoogle_ai_overviews- Google AI Overviews (Search)perplexity- Perplexity AImeta- Meta AIgoogle_ai_mode- Google AI Modegoogle_gemini- Google Geminicopilot- Microsoft Copilot
chatgpt, claude, google_ai_overviews, perplexity, meta, google_ai_mode, google_gemini, copilot, grok Response
Successful Response
Represents a prompt being tracked for AI visibility, including its configuration and metadata.
Unique identifier for the prompt
The prompt text being tracked
The customer journey stage this prompt represents. Returned as the display name of the brand's active stage — one of the brand's default set (Advice, Awareness, Evaluation, Comparison, Other for intent brands; Awareness, Consideration, Conversion, Loyalty, Other for funnel brands) or a custom stage name.
ID of the associated persona, if any
AI platforms this prompt is tracked on
chatgpt, claude, google_ai_overviews, perplexity, meta, google_ai_mode, google_gemini, copilot, grok Custom tags assigned to this prompt
Auto-detected or assigned topics for this prompt
Timestamp when the prompt was created