---
title: "Assign or unassign a status preset for a workspace."
method: PUT
path: "/api/status-presets/workspace/{workspaceId}"
tags: ["StatusPresets"]
---

# Assign or unassign a status preset for a workspace.

`PUT /api/status-presets/workspace/{workspaceId}`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/status-presets/workspace/{workspaceId}`
- Auth: HTTP bearer

Sets the status preset for the workspace. When switching from one preset to another (or from custom statuses to a preset), replacements must be provided for statuses that have items assigned to them. When unassigning a preset, statuses are duplicated from the preset to the workspace.<br/>Requirements:<br/>- auth-client scopes: "team"

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `actAsAdmin` boolean

## Request body

- SetWorkspaceStatusPresetRequest
  - `replacements` object, 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 removed when switching presets. This mapping will be used to migrate all items in the workspace to new statuses before deleting the old ones.
  - `statusPresetId` string, uuid: Status preset ID to assign to this workspace. Set to null to unassign the current preset.

## Response `204`

## Other responses

- `400`: If path parameters are invalid or payload is invalid or resource does not exist.
- `401`: If missing authentication token.
- `403`: If authenticated client does not have the required access scopes.
- `default`: If any other error happens.

---

[API](https://skmtc.dev/airfocus/apis/airfocus-api.md) · [All operations](https://skmtc.dev/airfocus/apis/airfocus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/airfocus/apis/airfocus-api/revisions/fc9ccaa2ec6d?raw)