Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.topify.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.