---
title: "Changes to Update a Workspace"
method: PATCH
path: "/v1/organizations/{organizationId}/workspaces/{workspaceId}"
---

# Changes to Update a Workspace

`PATCH /v1/organizations/{organizationId}/workspaces/{workspaceId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 41 revisions.

- **2026-03-04** `bfa460b2aec3` — 3 warning
- **2025-10-10** `0d907f2a3696` — 1 info
- **2025-10-09** `a6fde5be66ad` — 1 breaking, 1 info
- **2025-10-08** `00753fc6a7b0` — 5 warning, 13 info
- **2025-09-30** `db7f7dd086ea` — 2 warning
- **2025-08-13** `bc63c2cca59c` — 2 info
- **2025-08-07** `914a71ae4db3` — 1 info

## Changes

- **2026-03-04** `bfa460b2aec3` — 3 warning
  - the `alias` request property's maxLength was set to `30`
  - the `description` request property's maxLength was set to `255`
  - the `tags/items/` request property's maxLength was set to `30`
- **2025-10-10** `0d907f2a3696` — 1 info
  - removed the non-success response with the status `500`
- **2025-10-09** `a6fde5be66ad` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `204`
- **2025-10-08** `00753fc6a7b0` — 5 warning, 13 info
  - added the new `Active` enum value to the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - added the new `Deprovisioning` enum value to the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - added the new `Failed` enum value to the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - added the new `Inactive` enum value to the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - added the new `Provisioning` enum value to the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Active` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Cleanup-Completed` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Cleanup-Failed` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Cleanup-Requested` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Cleanup-Started` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Cleanup-Terraform-Completed` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Cleanup-Terraform-Failed` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Failed-Update` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Provisioned` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Provisioning` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Provisioning-Failed` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Requested` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
  - removed the `Workspace-Updated` enum value from the `state/allOf[#/components/schemas/WorkspaceState]/` response property for the response status `200`
- **2025-09-30** `db7f7dd086ea` — 2 warning
  - added the new `ap-southeast-1` enum value to the `region/allOf[#/components/schemas/AWSRegions]/` response property for the response status `200`
  - added the new `eu-central-2` enum value to the `region/allOf[#/components/schemas/AWSRegions]/` response property for the response status `200`
- **2025-08-13** `bc63c2cca59c` — 2 info
  - the endpoint scheme security `bearer` was removed from the API
  - the endpoint scheme security `oauth2` was removed from the API
- **2025-08-07** `914a71ae4db3` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/criblio/apis/cribl-cloud-public-api/docs/v1/organizations/:organizationId/workspaces/:workspaceId/patch.md) · [API](https://skmtc.dev/criblio/apis/cribl-cloud-public-api.md) · [Page](https://skmtc.dev/criblio/apis/cribl-cloud-public-api/changes/v1/organizations/:organizationId/workspaces/:workspaceId/patch)