Menu

Prompts

3 endpoints in the Mattering Networking API.

GETPOST prompts/ User APIService 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 APIhttps://networking.mattering.io/api/user/v1/prompts/
  • Service tierhttps://networking.mattering.io/api/internal/v1/prompts/

Query parameters

NameDefault
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

StatusCode
400bad_action
400validation
401unauthorized
404not_found

Example

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

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

GETPOST prompts/{code}/ User APIService 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 APIhttps://networking.mattering.io/api/user/v1/prompts/{code}/
  • Service tierhttps://networking.mattering.io/api/internal/v1/prompts/{code}/

Path parameters

NameType
codeslug

Query parameters

NameDefault
spacenone

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

StatusCode
400bad_action
401unauthorized
404not_found

Example

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

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

GETPOST prompts/{code}/answers/ User APIService 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 APIhttps://networking.mattering.io/api/user/v1/prompts/{code}/answers/
  • Service tierhttps://networking.mattering.io/api/internal/v1/prompts/{code}/answers/

Path parameters

NameType
codeslug

Query parameters

NameDefault
spacenone

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

StatusCode
400bad_action
400validation
401unauthorized
404not_found

Example

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

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

All Networking resources
Start Free Explore our Products