GETPOST
topics/
User APIService tier
List topics, or create one with POST. derived from route
This read is not paginated. It returns at most 300 rows and does not report a total, so a result of exactly 300 may be truncated.
URL
- User APIhttps://networking.mattering.io/api/user/v1/topics/
- Service tierhttps://networking.mattering.io/api/internal/v1/topics/
Query parameters
| Name | Default |
|---|---|
include | none |
space | none |
Responses
200 data and meta envelope
{
"data": [
{
"id": "...",
"name": "...",
"description": "...",
"stance": "...",
"color": "...",
"icon": "...",
"order": 0,
"prompts": [
{
"id": "...",
"topic": "...",
"topic_name": "...",
"text": "...",
"phrasings": "...",
"frequency": "...",
"difficulty": "...",
"confidence": "...",
"due_at": "2026-01-01T00:00:00Z",
"settings": [
"..."
],
"notes": [
"..."
],
"source_debrief": "...",
"is_active": true,
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"answers": [
{
"id": "...",
"text": "...",
"length": "...",
"tone": "...",
"story": "...",
"pivot": "...",
"is_default": true,
"notes": [
"..."
]
}
]
}
]
}
],
"meta": {
"count": 0
}
}
200 data and meta envelope
{
"data": {
"id": "...",
"name": "...",
"description": "...",
"stance": "...",
"color": "...",
"icon": "...",
"order": 0,
"prompts": [
{
"id": "...",
"topic": "...",
"topic_name": "...",
"text": "...",
"phrasings": "...",
"frequency": "...",
"difficulty": "...",
"confidence": "...",
"due_at": "2026-01-01T00:00:00Z",
"settings": [
"..."
],
"notes": [
"..."
],
"source_debrief": "...",
"is_active": true,
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"answers": [
{
"id": "...",
"text": "...",
"length": "...",
"tone": "...",
"story": "...",
"pivot": "...",
"is_default": true,
"notes": [
"..."
]
}
]
}
]
}
}
200 data and meta envelope
{
"data": {
"deleted": "..."
}
}
201 data and meta envelope
{
"data": {
"id": "...",
"name": "...",
"description": "...",
"stance": "...",
"color": "...",
"icon": "...",
"order": 0,
"prompts": [
{
"id": "...",
"topic": "...",
"topic_name": "...",
"text": "...",
"phrasings": "...",
"frequency": "...",
"difficulty": "...",
"confidence": "...",
"due_at": "2026-01-01T00:00:00Z",
"settings": [
"..."
],
"notes": [
"..."
],
"source_debrief": "...",
"is_active": true,
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"answers": [
{
"id": "...",
"text": "...",
"length": "...",
"tone": "...",
"story": "...",
"pivot": "...",
"is_default": true,
"notes": [
"..."
]
}
]
}
]
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 400 | bad_action |
| 400 | validation |
| 401 | unauthorized |
| 404 | not_found |
Example
curl -X GET "https://networking.mattering.io/api/user/v1/topics/?include=...&space=..." \ -H "Authorization: Bearer $MATTERING_API_KEY"
curl -X GET "https://networking.mattering.io/api/internal/v1/topics/?include=...&space=..." \ -H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \ -H "X-Internal-Org-Id: $ORG_ID" \ -H "X-Internal-User-Email: you@example.com"
Source: NetworkingCore/internal_api.py (internal_api.topics_collection)