Create Query Run

Manually trigger a query run for a prompt on a specific AI platform.

POST /ai-analytics-service/api/public/v1/query-runs

Create Query Run

cURL

curl --request POST \
  --url https://api.slatehq.ai/ai-analytics-service/api/public/v1/query-runs \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "promptId": 123,
  "topicId": 123,
  "platform": "<string>",
  "brandId": 123
}
'

200

{
  "id": 123,
  "promptId": 123,
  "topicId": 123,
  "platform": "<string>",
  "status": "<string>",
  "startedAt": "<string>",
  "completedAt": "<string>",
  "errorMessage": "<string>"
}

Creates a new query run. Use this to manually trigger a prompt query outside its scheduled cron cycle.

Parameters

Authorization · string · required

Bearer token. Format: Bearer slat_<your-token>.

promptId · number · required

ID of the prompt to run.

topicId · number · required

Topic ID associated with the prompt.

platform · string · required

AI platform to query. One of: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

brandId · number

Brand ID for the query run.

Response

Returns 200 OK with the created query run.

id · number · required

Unique identifier for the query run.

promptId · number · required

Associated prompt ID.

topicId · number · required

Associated topic ID.

platform · string · required

AI platform used for the query.

status · string · required

Run status. Starts as PENDING.

startedAt · string · required

Timestamp when the run was created. ISO 8601 format.

completedAt · string

Completion timestamp. null while the run is in progress.

errorMessage · string

Error details if the run failed. null on success.

Example

cURL

curl -s -X POST "https://api.slatehq.ai/ai-analytics-service/api/public/v1/query-runs" \
  -H "Authorization: Bearer slat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "promptId": 156,
    "topicId": 42,
    "platform": "CHATGPT"
  }'

Response

{
  "id": 2048,
  "promptId": 156,
  "topicId": 42,
  "platform": "CHATGPT",
  "status": "PENDING",
  "startedAt": "2026-02-11T14:30:00Z",
  "completedAt": null,
  "errorMessage": null
}

Status codes

Status	Description
200	Query run created.
400	Invalid request. Missing required fields or invalid platform.
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Query Run — Check the status of a query run.
• Get Run Details — View the full AI response and metrics.