Skip to main content
POST
Create Query Run
Creates a query run record for a prompt. This endpoint only stores the record: it doesn’t send the prompt to the AI platform, and the new run’s status is null. To query the AI platforms right away, create the prompt with run=true (see Create Prompt).

Parameters

string
required
Bearer token. Format: Bearer slat_<your-token>.
number
required
ID of an active prompt in your workspace.
number
Ignored. The run always uses the prompt’s topic.
string
required
AI platform for the run. One of: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE. The platform isn’t checked against the prompt’s configured platforms.
number
Ignored. The run always uses the prompt’s brand.

Response

Returns 200 OK with the created query run.
number
required
Unique identifier for the query run.
number
required
Associated prompt ID.
number
required
Associated topic ID.
string
required
AI platform used for the query.
string
Run status. null for runs created with this endpoint.
string
required
Timestamp when the run was created. ISO 8601 format.
string
Completion timestamp. null while the run is in progress.
string
Error details if the run failed. null on success.

Example

Response

Status codes

What’s next