Menu

Status presets

2 endpoints in the Mattering Productivity API.

GET spaces/{space_id}/status-presets/list/ User APIService tier

List all status presets in the organization (resolved via space).

This read is not paginated. It returns at most 8 rows and does not report a total, so a result of exactly 8 may be truncated.

URL

  • User APIhttps://productivity.mattering.io/api/user/v1/spaces/{space_id}/status-presets/list/
  • Service tierhttps://productivity.mattering.io/api/internal/spaces/{space_id}/status-presets/list/

Path parameters

NameType
space_idstr

Responses

200 bare JSON object (no envelope)

{
  "success": true,
  "status_presets": [
    {
      "public_id": "...",
      "name": "...",
      "description": "...",
      "is_default_for_space": true,
      "statuses": [
        {
          "id": "...",
          "name": "...",
          "color": "...",
          "order": 0
        }
      ],
      "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
401missing_actor
401unauthorized
403forbidden
404space_not_found

Example

curl -X GET "https://productivity.mattering.io/api/user/v1/spaces/SPACE_ID/status-presets/list/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: MatteringPMCore/internal_api.py (internal_api.internal_list_status_presets)

POST status-presets/manage/ User APIService tier

Create / update / delete / set-default an organization status preset.

Required: action ('create' | 'update' | 'delete' | 'set_default'), space_id. Create: name, optional description, statuses (list of {name, color}), is_default. Update / delete / set_default: preset_id. set_default sets the preset as the default *for this space*.

This read is not paginated. It returns at most 8 rows and does not report a total, so a result of exactly 8 may be truncated.

URL

  • User APIhttps://productivity.mattering.io/api/user/v1/status-presets/manage/
  • Service tierhttps://productivity.mattering.io/api/internal/status-presets/manage/

Body keys (JSON)

KeyRequiredDefault
actionoptional or conditionalnone
descriptionoptional or conditionalnone
is_defaultoptional or conditionalnone
nameoptional or conditionalnone
preset_idoptional or conditionalnone
space_idoptional or conditionalnone
statusesoptional or conditionalnone
user_idoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "success": true,
  "message": "..."
}

200 bare JSON object (no envelope)

{
  "success": true,
  "status_preset": {
    "public_id": "...",
    "name": "...",
    "description": "...",
    "is_default_for_space": true,
    "statuses": [
      {
        "id": "...",
        "name": "...",
        "color": "...",
        "order": 0
      }
    ],
    "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
400duplicate_name
400invalid_action
400name_required
400preset_id_required
401missing_actor
401unauthorized
403forbidden
404preset_not_found
404space_not_found

Example

curl -X POST "https://productivity.mattering.io/api/user/v1/status-presets/manage/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "...",
  "description": "...",
  "is_default": "...",
  "name": "...",
  "preset_id": "...",
  "space_id": "...",
  "statuses": "...",
  "user_id": "..."
}'

Source: MatteringPMCore/internal_api.py (internal_api.internal_manage_status_preset)

All Productivity resources
Start Free Explore our Products