Topics
Topics define the questions and themes Mentova tracks for a brand. When a topic is created, prompts are automatically generated from the seed phrase.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /brands/{brandId}/topics | List topics for a brand |
POST | /brands/{brandId}/topics | Create a topic |
DELETE | /brands/{brandId}/topics/{topicId} | Delete a topic |
GET /brands//topics
curl https://mentova.ai/api/v1/brands/clxabc123/topics \
-H "X-API-Key: mtv_live_your_key"
Response 200
{
"data": [
{
"id": "clxtopic1",
"brandId": "clxabc123",
"seed": "What is the best project management tool for remote teams?",
"language": "en",
"country": "US",
"createdAt": "2026-02-01T09:00:00.000Z"
}
]
}
POST /brands//topics
Create a new topic. Mentova will auto-generate prompts from the seed phrase.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
seed | string | Yes | Seed question or phrase (3-200 chars) |
language | string | No | BCP-47 language code (2-5 chars) |
country | string | No | ISO 3166-1 alpha-2 country code (2-5 chars) |
curl -X POST https://mentova.ai/api/v1/brands/clxabc123/topics \
-H "X-API-Key: mtv_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"seed": "What is the best project management tool for remote teams?",
"language": "en",
"country": "US"
}'
Response 201
{
"data": {
"id": "clxtopic1",
"brandId": "clxabc123",
"seed": "What is the best project management tool for remote teams?",
"language": "en",
"country": "US",
"createdAt": "2026-06-01T09:00:00.000Z"
}
}
DELETE /brands//topics/
Permanently delete a topic and all its prompts and campaign runs.
curl -X DELETE https://mentova.ai/api/v1/brands/clxabc123/topics/clxtopic1 \
-H "X-API-Key: mtv_live_your_key"
Response 200
{
"data": { "deleted": true }
}
Prompts
Prompts are the individual questions auto-generated from topics. They are sent to LLMs during campaigns.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /brands/{brandId}/prompts | List prompts with optional filters |
GET /brands//prompts
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
model | string | - | Filter by LLM model enum value |
status | string | - | Filter by prompt status |
limit | integer | 50 | Max results (capped at 200) |
offset | integer | 0 | Pagination offset |
curl "https://mentova.ai/api/v1/brands/clxabc123/prompts?limit=10&offset=0" \
-H "X-API-Key: mtv_live_your_key"
Response 200
{
"data": [
{
"id": "clxprompt1",
"text": "What project management software do remote teams prefer?",
"createdAt": "2026-02-01T09:00:00.000Z",
"topic": {
"id": "clxtopic1",
"seed": "What is the best project management tool for remote teams?"
}
}
],
"total": 24,
"limit": 10,
"offset": 0
}