GET /topics
Returns a list of all topics associated with your account that have completed setup.
Request
HTTP Method
GET
Endpoint
/api/v1/topics
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API authentication key |
Example Request curl -X GET "https://knowatoa.com/api/v1/topics?api_key=YOUR_API_KEY"
Response
Success Response (200 OK)
Returns a JSON object containing an array of topics:
{
"topics": [
{
"id": "tpc_abc123",
"name": "Example Topic"
},
{
"id": "tpc_def456",
"name": "Another Topic"
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
| topics | array | Array of topic objects |
| topics[].id | string | Unique identifier for the topic (prefix_id) |
| topics[].name | string | Display name of the topic |
Error Responses
401 Unauthorized
{
"error": "API key is required"
}
{
"error": "Invalid API key"
}
{
"error": "API key is not active"
}
Notes
- Topics are filtered by the account associated with the API key