Menu

Stories

2 endpoints in the Mattering Networking API.

GETPOST stories/ User APIService tier

List stories, 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/stories/
  • Service tierhttps://networking.mattering.io/api/internal/v1/stories/

Query parameters

NameDefault
settingnone
spacenone

Responses

200 data and meta envelope

{
  "data": [
    {
      "id": "...",
      "title": "...",
      "hook": "...",
      "body": "...",
      "punchline": "...",
      "pivot": "...",
      "kind": "...",
      "tone": "...",
      "length": "...",
      "topics": "...",
      "times_told": "...",
      "last_told_at": "2026-01-01T00:00:00Z",
      "confidence": "...",
      "due_at": "2026-01-01T00:00:00Z",
      "is_active": true,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z",
      "settings": [
        {
          "setting": "...",
          "fit": "...",
          "notes": [
            "..."
          ]
        }
      ]
    }
  ],
  "meta": {
    "count": 0
  }
}

201 data and meta envelope

{
  "data": {
    "id": "...",
    "title": "...",
    "hook": "...",
    "body": "...",
    "punchline": "...",
    "pivot": "...",
    "kind": "...",
    "tone": "...",
    "length": "...",
    "topics": "...",
    "times_told": "...",
    "last_told_at": "2026-01-01T00:00:00Z",
    "confidence": "...",
    "due_at": "2026-01-01T00:00:00Z",
    "is_active": true,
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-01T00:00:00Z",
    "settings": [
      {
        "setting": "...",
        "fit": "...",
        "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

Example

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

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

GETPOST stories/{code}/ User APIService tier

Read or change one of the stories by id. derived from route

URL

  • User APIhttps://networking.mattering.io/api/user/v1/stories/{code}/
  • Service tierhttps://networking.mattering.io/api/internal/v1/stories/{code}/

Path parameters

NameType
codeslug

Query parameters

NameDefault
spacenone

Responses

200 data and meta envelope

{
  "data": {
    "id": "...",
    "title": "...",
    "hook": "...",
    "body": "...",
    "punchline": "...",
    "pivot": "...",
    "kind": "...",
    "tone": "...",
    "length": "...",
    "topics": "...",
    "times_told": "...",
    "last_told_at": "2026-01-01T00:00:00Z",
    "confidence": "...",
    "due_at": "2026-01-01T00:00:00Z",
    "is_active": true,
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-01T00:00:00Z",
    "settings": [
      {
        "setting": "...",
        "fit": "...",
        "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

StatusCode
400bad_action
401unauthorized
404not_found

Example

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

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

All Networking resources
Start Free Explore our Products