teams

Add a custom status to the team palette.

Appends a stage after the last one. Every project that follows the team shows it immediately. At most 15 statuses per palette. upgrade_required on a workspace without a paid plan. MCP sibling: teams_statuses_create.

post/teams/{id}/statuses

Request

  • Base URL: https://restivity.ai/api/v1
  • URL: https://restivity.ai/api/v1/teams/{id}/statuses
  • Auth: OAuth 2 (authorization code, authorization URL https://restivity.ai/oauth/authorize, token URL https://restivity.ai/api/oauth/token, scopes: projects:write)

Path parameters

idstring uuid required

Unique Team identifier.

Request body

namestring required

Stage label as shown on the board, e.g. "In review".

colorstring required

Hex color for the column, e.g. "#8B5CF6".

category'todo' | 'in_progress' | 'completed'

Defaults to 'in_progress' when omitted — most custom stages refine the active phase.

Response

The created status row.

idstring uuid required
workspace_idstring uuid nullable required

Set when the status belongs to a workspace palette; otherwise null.

team_idstring uuid nullable required

Set when the status belongs to a team palette; otherwise null.

project_idstring uuid nullable required

Set when the status belongs to the project's own palette; null for a workspace or team status.

namestring required
colorstring required
positioninteger required

Pipeline order, ascending.

category'todo' | 'in_progress' | 'completed' required
created_atstring required

Changes

No recorded changes to this operation across all 1 revision of this API.