Workspaces

Configure workspace statuses.

Sets statuses (all at once) for the specified workspace. New statuses in the list will be added to the database, missing statuses will be removed from the database, all other statuses will be updated. Each workspace must have at least one status in each category: 'draft', 'active', 'closed'<br/>Requirements:<br/>- auth-client scopes: "workspace"<br/>- user permission: "write" or higher

post/api/workspaces/{workspaceId}/statuses

Request

  • Base URL: https://app.airfocus.com
  • URL: https://app.airfocus.com/api/workspaces/{workspaceId}/statuses
  • Auth: HTTP bearer

Path parameters

workspaceIdstring uuid required

Query parameters

actAsAdminboolean

Enable sudo-mode for admins for a single request, which gives full permission to all workspaces in the team.

Request body

replacementsobject required

A map of status replacements, where key is and OLD status-id and value is a NEW status-id. Replacements must be specified for each status being deleted from the workspace.This mapping will be used to migrate all items in the workspace to new statuses before deleting the old ones.

Example request

{
  "statuses": [
    {
      "category": "active",
      "color": "blue",
      "default": true,
      "id": "7e5a6ca1-93e2-3b2b-8c07-c911b370ff40",
      "name": "In Progress",
      "order": 1,
      "presetId": "aabe8348-a1b8-371c-be47-4c43039dcc6e",
      "workspaceId": "668953d2-25f2-34fd-bd72-1e8cf024a277"
    }
  ]
}

Changes

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