Menu

Tabs

1 endpoint in the Mattering Productivity API.

POST tabs/manage/ User APIService tier

Create, update, or delete a project tab.

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/tabs/manage/
  • Service tierhttps://productivity.mattering.io/api/internal/tabs/manage/

Body keys (JSON)

KeyRequiredDefault
actionoptional or conditionalnone
is_defaultoptional or conditionalfalse
nameoptional or conditionalNew Tab
project_idoptional or conditionalnone
tab_idoptional 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,
  "tab": {
    "id": "...",
    "name": "..."
  }
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400cannot delete the last tab message
400invalid action message
401missing_actor
401unauthorized
403forbidden
404project_not_found
404tab_not_found

Example

curl -X POST "https://productivity.mattering.io/api/user/v1/tabs/manage/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "...",
  "is_default": false,
  "name": "New Tab",
  "project_id": "...",
  "tab_id": "...",
  "user_id": "..."
}'

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

All Productivity resources
Start Free Explore our Products