List Prompts

Retrieve a paginated list of prompts in your workspace.

GET /ai-analytics-service/api/public/v1/prompts

List Prompts

cURL

curl --request GET \
  --url https://api.slatehq.ai/ai-analytics-service/api/public/v1/prompts \
  --header 'Authorization: <authorization>'

200

{
  "content": [
    {
      "prompt": {
        "id": 123,
        "topicId": 123,
        "promptText": "<string>",
        "platform": [
          "<string>"
        ],
        "cronExpr": "<string>",
        "timezone": "<string>",
        "active": true,
        "location": "<string>",
        "nextRun": "<string>",
        "lastRun": "<string>"
      },
      "topicName": "<string>"
    }
  ],
  "totalElements": 123,
  "totalPages": 123,
  "number": 123,
  "size": 123
}

Returns a paginated list of prompts in the token’s workspace. Use query parameters to filter by topic, platform, location, or search by text.

Parameters

Authorization · string · required

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

page · integer

Page number (0-indexed). Default: 0.

size · integer

Number of prompts per page. Default: 10.

topicId · number

Filter by topic ID.

brandId · number

Filter by brand ID.

location · string

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

search · string

Search prompts by text. Case-insensitive partial match.

platform · string[]

Filter by one or more platforms: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

location · string

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

Response

Returns 200 OK with a paginated list of prompts.

content · object[] · required

Array of prompt objects with topic info.

Show prompt with topic object

prompt · object · required

The prompt details.

Show prompt object

id · number · required

Prompt ID.

topicId · number · required

Topic ID.

promptText · string · required

The 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. ISO 8601 format.

lastRun · string

Last run time. ISO 8601 format.

topicName · string · required

Name of the associated topic.

totalElements · integer · required

Total number of prompts matching the filters.

totalPages · integer · required

Total number of pages.

number · integer · required

Current page number (0-indexed).

size · integer · required

Page size.

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/prompts?topicId=42&page=0&size=10" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

{
  "content": [
    {
      "prompt": {
        "id": 156,
        "topicId": 42,
        "promptText": "What is the best project management tool for remote teams?",
        "platform": ["CHATGPT", "PERPLEXITY"],
        "cronExpr": "0 0 * * *",
        "timezone": "UTC",
        "active": true,
        "location": "US",
        "nextRun": "2026-02-12T00:00:00Z",
        "lastRun": "2026-02-11T00:00:00Z"
      },
      "topicName": "Project Management Tools"
    }
  ],
  "totalElements": 24,
  "totalPages": 3,
  "number": 0,
  "size": 10
}

Results are sorted by createdAt in descending order (newest first). Page numbering starts at 0.

Status codes

Status	Description
200	List returned.
400	Invalid location code or query parameter.
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Prompt — Get details for a specific prompt.
• Create Prompt — Add a new prompt.