Skip to main content
POST
Create Prompt
Creates a new prompt under a specific topic. Optionally triggers an immediate query run across the selected AI platforms.

Parameters

string
required
Bearer token. Format: Bearer slat_<your-token>.
boolean
Set to true to immediately trigger a live query run after creating the prompt. Default: false.
number
required
ID of the topic this prompt belongs to. Must reference an existing topic in your workspace.
string
required
The prompt text to track. Maximum 4000 characters.
string[]
required
AI platforms to query. One or more of: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.
string
required
Cron expression defining the query schedule (e.g., 0 0 * * * for daily).
string
required
Timezone for the cron schedule (e.g., UTC, America/New_York).
boolean
Whether the prompt is active. Default: true.
string
ISO 3166-1 alpha-2 country code for location-specific results (e.g., US, GB, IN). Maximum 2 characters.

Response

Returns 201 Created with the new prompt.
number
required
Unique identifier for the prompt.
number
required
Topic ID the prompt belongs to.
string
required
The prompt text.
string[]
required
Target AI platforms.
string
required
Cron schedule expression.
string
required
Schedule timezone.
boolean
required
Whether the prompt is active.
string
Country code for location filtering. null if not set.
string
Next scheduled run time. ISO 8601 format.
string
Last run time. ISO 8601 format. null if the prompt has not run yet.

Example

Response

Status codes

What’s next