Menu

Topics

1 endpoint in the Mattering Networking API.

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

NameDefault
includenone
spacenone

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

StatusCode
400bad_action
400validation
401unauthorized
404not_found

Example

curl -X GET "https://networking.mattering.io/api/user/v1/topics/?include=...&space=..." \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: NetworkingCore/internal_api.py (internal_api.topics_collection)

All Networking resources
Start Free Explore our Products