Skip to main content
Topics are groups that organize your prompts by theme or category (e.g., “Product comparisons”, “Pricing questions”). Each prompt belongs to one topic.

​
List topics

GET /projects/{project_id}/topics
Returns all topics in a project.

​
Path parameters

ParamTypeDescription
project_idstring (UUID)The project ID

​
Query parameters

None. 
curl "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/topics" \
  -H "X-API-Key: tk_live_..."

​
Response

{
  "success": true,
  "data": [
    {
      "topic_id": "t1u2v3w4-...",
      "project_id": "a1b2c3d4-...",
      "name": "Product comparisons",
      "description": "Prompts comparing products in the category",
      "created_at": "2026-01-20T14:00:00+00:00"
    },
    {
      "topic_id": "u5v6w7x8-...",
      "project_id": "a1b2c3d4-...",
      "name": "Pricing questions",
      "description": null,
      "created_at": "2026-01-20T14:05:00+00:00"
    }
  ]
}

​
TopicResponse fields

FieldTypeNullableDescription
topic_idstring (UUID)NoTopic ID
project_idstring (UUID)NoParent project ID
namestringNoTopic display name
descriptionstringYesTopic description
created_atstring (ISO 8601)NoCreation timestamp
Use the topic_id to correlate prompts to their topic group via the topic_id field in the prompts and overview endpoints.