StatusPresets

Update statuses of a status preset

Updates the statuses linked to a status preset. Replacements must be specified for each status being removed, so that items in workspaces using this preset can be migrated to new statuses.<br/>Requirements:<br/>- auth-client scopes: "team"

put/api/status-presets/{statusPresetId}/statuses

Request

  • Base URL: https://app.airfocus.com
  • URL: https://app.airfocus.com/api/status-presets/{statusPresetId}/statuses
  • Auth: HTTP bearer

Path parameters

statusPresetIdstring 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 an 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"
    }
  ]
}

Response

idstring uuid required
namestring required

Name of this status preset.

teamIdstring uuid required

Example response

{
  "_embedded": {
    "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.