---
title: "Rename a workspace"
method: PATCH
path: "/workspaces/{workspace_id}"
tags: ["Organization"]
---

# Rename a workspace

`PATCH /workspaces/{workspace_id}`

Change a workspace's display name. Available to workspace owners, company owners, and properly permissioned API keys.

## Path parameters

- `workspace_id` string, required

## Headers

- `If-Match` string

## Request body

- WorkspaceUpdate — Changes to apply to a workspace
  - `name` string, required — The new display name for the workspace

## Response `200`

The workspace after applying the update

- Workspace — A mabl workspace
  - `id` string — The id of the workspace
  - `name` string — The display name of the workspace
  - `account_id` string — The id of the billing account that owns the workspace
  - `created_time` integer — Time at which the workspace was created, in epoch milliseconds

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Workspace not found
- `412` — The If-Match header version does not match the current version of the workspace
- `default` — Unknown error

## Changes

- **2026-09-01** `2938d8f6f737` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mabl/apis/mabl-api/changes/workspaces/:workspace_id/patch.md)

---

[API](https://skmtc.dev/mabl/apis/mabl-api.md) · [All operations](https://skmtc.dev/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/2938d8f6f737/schema)