Update Prompt

Update an existing prompt’s text, schedule, platforms, or location.

PUT /ai-analytics-service/api/public/v1/prompts/{id}

Update Prompt

cURL

curl --request PUT \
  --url https://api.slatehq.ai/ai-analytics-service/api/public/v1/prompts/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "topicId": 123,
  "promptText": "<string>",
  "platform": [
    "<string>"
  ],
  "cronExpr": "<string>",
  "timezone": "<string>",
  "active": true,
  "location": "<string>"
}
'

200

{
  "id": 123,
  "topicId": 123,
  "promptText": "<string>",
  "platform": [
    "<string>"
  ],
  "cronExpr": "<string>",
  "timezone": "<string>",
  "active": true,
  "location": "<string>",
  "nextRun": "<string>",
  "lastRun": "<string>"
}

Updates the specified prompt. You can modify the prompt text, target platforms, cron schedule, timezone, active status, or location.

Parameters

id · number · required

Unique identifier for the prompt to update.

Authorization · string · required

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

topicId · number · required

Topic ID the prompt belongs to.

promptText · string · required

The prompt text. Maximum 4000 characters.

platform · string[] · required

AI platforms to query. One or more of: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

cronExpr · string · required

Cron expression for the query schedule.

timezone · string · required

Timezone for the cron schedule.

active · boolean

Whether the prompt is active.

location · string

ISO 3166-1 alpha-2 country code (e.g., US, GB). Maximum 2 characters.

Response

Returns 200 OK with the updated prompt.

id · number · required

Prompt ID.

topicId · number · required

Topic ID.

promptText · string · required

The updated prompt text.

platform · string[] · required

Target AI platforms.

cronExpr · string · required

Cron schedule expression.

timezone · string · required

Schedule timezone.

active · boolean · required

Whether the prompt is active.

location · string

Country code. null if not set.

nextRun · string

Next scheduled run time. ISO 8601 format.

lastRun · string

Last run time. ISO 8601 format.

Example

cURL

curl -s -X PUT "https://api.slatehq.ai/ai-analytics-service/api/public/v1/prompts/156" \
  -H "Authorization: Bearer slat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "topicId": 42,
    "promptText": "What are the top project management tools for distributed teams in 2026?",
    "platform": ["CHATGPT", "PERPLEXITY", "GEMINI"],
    "cronExpr": "0 0 * * *",
    "timezone": "UTC",
    "active": true,
    "location": "US"
  }'

Response

{
  "id": 156,
  "topicId": 42,
  "promptText": "What are the top project management tools for distributed teams in 2026?",
  "platform": ["CHATGPT", "PERPLEXITY", "GEMINI"],
  "cronExpr": "0 0 * * *",
  "timezone": "UTC",
  "active": true,
  "location": "US",
  "nextRun": "2026-02-12T00:00:00Z",
  "lastRun": "2026-02-11T00:00:00Z"
}

Status codes

Status	Description
200	Prompt updated.
400	Invalid request. Missing required fields, topic not found, or invalid location code.
401	Missing or invalid Bearer token. See Authentication.
404	Prompt not found.
500	Internal server error.

What’s next

• Get Prompt — View the current prompt details.
• Delete Prompt — Remove a prompt.