GET POST
prompts/
User API Service tier
List prompts, 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 API https://networking.mattering.io/api/user/v1/prompts/
Service tier https://networking.mattering.io/api/internal/v1/prompts/
Query parameters
Name Default
settingnone spacenone topicnone unanswerednone
Responses
200 data and meta envelope
{
"data": [
{
"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
}
}
201 data and meta envelope
{
"data": {
"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_action400 validation401 unauthorized404 not_found
Example
User API Service tier
curl -X GET "https://networking.mattering.io/api/user/v1/prompts/?setting=...&space=...&topic=..." \
-H "Authorization: Bearer $MATTERING_API_KEY" curl -X GET "https://networking.mattering.io/api/internal/v1/prompts/?setting=...&space=...&topic=..." \
-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.prompts_collection)
GET POST
prompts/{code} /
User API Service tier
Read or change one of the prompts by id. 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 API https://networking.mattering.io/api/user/v1/prompts/{code} /
Service tier https://networking.mattering.io/api/internal/v1/prompts/{code} /
Path parameters
Query parameters
Responses
200 data and meta envelope
{
"data": {
"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": "..."
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
Status Code
400 bad_action401 unauthorized404 not_found
Example
User API Service tier
curl -X GET "https://networking.mattering.io/api/user/v1/prompts/CODE/?space=..." \
-H "Authorization: Bearer $MATTERING_API_KEY" curl -X GET "https://networking.mattering.io/api/internal/v1/prompts/CODE/?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.prompt_detail)
GET POST
prompts/{code} /answers/
User API Service tier
Read or change one of the prompts by id. 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 API https://networking.mattering.io/api/user/v1/prompts/{code} /answers/
Service tier https://networking.mattering.io/api/internal/v1/prompts/{code} /answers/
Path parameters
Query parameters
Responses
200 data and meta envelope
{
"data": [
{
"id": "...",
"text": "...",
"length": "...",
"tone": "...",
"story": "...",
"pivot": "...",
"is_default": true,
"notes": [
"..."
]
}
],
"meta": {
"count": 0
}
}
200 data and meta envelope
{
"data": {
"deleted": "..."
}
}
200 data and meta envelope
{
"data": {
"id": "...",
"text": "...",
"length": "...",
"tone": "...",
"story": "...",
"pivot": "...",
"is_default": true,
"notes": [
"..."
]
}
}
201 data and meta envelope
{
"data": {
"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_action400 validation401 unauthorized404 not_found
Example
User API Service tier
curl -X GET "https://networking.mattering.io/api/user/v1/prompts/CODE/answers/?space=..." \
-H "Authorization: Bearer $MATTERING_API_KEY" curl -X GET "https://networking.mattering.io/api/internal/v1/prompts/CODE/answers/?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.prompt_answers)