Menu

Settings

3 endpoints in the Mattering Networking API.

GETPOST settings/ User APIService tier

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

Query parameters

NameDefault
spacenone

Responses

200 data and meta envelope

{
  "data": [
    {
      "id": "...",
      "name": "...",
      "kind": "...",
      "description": "...",
      "goal": "...",
      "anchor": "...",
      "exit_plan": "...",
      "triggers": [
        "..."
      ],
      "comfort": "...",
      "color": "...",
      "icon": "...",
      "is_active": true,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ],
  "meta": {
    "count": 0,
    "space": "..."
  }
}

201 data and meta envelope

{
  "data": {
    "id": "...",
    "name": "...",
    "kind": "...",
    "description": "...",
    "goal": "...",
    "anchor": "...",
    "exit_plan": "...",
    "triggers": [
      "..."
    ],
    "comfort": "...",
    "color": "...",
    "icon": "...",
    "is_active": true,
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-01T00:00:00Z"
  }
}

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/settings/?space=..." \
  -H "Authorization: Bearer $MATTERING_API_KEY"

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

GETPOST settings/{code}/ User APIService tier

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

URL

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

Path parameters

NameType
codeslug

Query parameters

NameDefault
spacenone

Responses

200 data and meta envelope

{
  "data": {
    "id": "...",
    "name": "...",
    "kind": "...",
    "description": "...",
    "goal": "...",
    "anchor": "...",
    "exit_plan": "...",
    "triggers": [
      "..."
    ],
    "comfort": "...",
    "color": "...",
    "icon": "...",
    "is_active": true,
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-01T00:00:00Z"
  }
}

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/settings/CODE/?space=..." \
  -H "Authorization: Bearer $MATTERING_API_KEY"

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

GET settings/{code}/prep/ User APIService tier

The prep sheet as data: anchor, rules by phase, stories, prompts + answers.

URL

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

Path parameters

NameType
codeslug

Query parameters

NameDefault
spacenone

Responses

200 data and meta envelope

{
  "data": {
    "setting": {
      "id": "...",
      "name": "...",
      "kind": "...",
      "description": "...",
      "goal": "...",
      "anchor": "...",
      "exit_plan": "...",
      "triggers": [
        "..."
      ],
      "comfort": "...",
      "color": "...",
      "icon": "...",
      "is_active": true,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    },
    "rules": [
      {
        "phase": "...",
        "label": "...",
        "rules": [
          {
            "id": "...",
            "setting": "...",
            "phase": "...",
            "text": "...",
            "why": "...",
            "order": 0,
            "is_active": true,
            "confidence": "...",
            "due_at": "2026-01-01T00:00:00Z"
          }
        ]
      }
    ],
    "stories": {
      "great": [
        {
          "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": [
                "..."
              ]
            }
          ]
        }
      ],
      "ok": [
        {
          "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": [
                "..."
              ]
            }
          ]
        }
      ],
      "avoid": [
        {
          "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": [
                "..."
              ]
            }
          ]
        }
      ]
    },
    "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
401unauthorized
404not_found

Example

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

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

All Networking resources
Start Free Explore our Products