List Topics

Retrieve all topics in your workspace.

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

List Topics

cURL

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

200

{
  "topics": [
    {
      "id": 123,
      "workspaceId": 123,
      "brandId": 123,
      "topicName": "<string>",
      "description": "<string>"
    }
  ]
}

Returns all topics in the token’s workspace. Optionally filter by brand.

Parameters

Authorization · string · required

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

brandId · number

Filter topics by brand ID.

Response

Returns 200 OK with an array of topics.

topics · object[] · required

Array of topic objects.

Show topic object

id · number · required

Topic ID.

workspaceId · number · required

Workspace the topic belongs to.

brandId · number

Associated brand ID. null if not set.

topicName · string · required

Topic name.

description · string

Topic description. null if not set.

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/topics" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

[
  {
    "id": 42,
    "workspaceId": 1,
    "brandId": null,
    "topicName": "Project Management Tools",
    "description": "Track AI mentions of project management software"
  },
  {
    "id": 43,
    "workspaceId": 1,
    "brandId": 5,
    "topicName": "SEO Strategy",
    "description": "Monitor SEO-related AI responses"
  }
]

Status codes

Status	Description
200	Topics returned.
401	Missing or invalid Bearer token. See Authentication.
404	No topics found for the specified brand.
500	Internal server error.

What’s next

• Create Topic — Add a new topic.
• Create Prompt — Add prompts to a topic.