---
title: "Update workspace"
method: PATCH
path: "/v1/workspaces/{workspaceId}"
tags: ["Workspaces"]
---

# Update workspace

`PATCH /v1/workspaces/{workspaceId}`

Update workspace properties

## Request body

- UpdateWorkspaceRequest
  - `name` string — Display name of the workspace
  - `slug` string — URL-friendly unique identifier (lowercase, no spaces)

## Response `200`

Workspace updated successfully

- Workspace
  - `awsRoleArn` string, nullable — AWS IAM role ARN for integrations
  - `createdAt` string, date-time, required — Timestamp when workspace was created
  - `googleServiceAccountEmail` string, email, nullable — Google service account email for integrations
  - `id` string, uuid, required — Unique identifier for the workspace
  - `name` string, required — Display name of the workspace
  - `slug` string, required — URL-friendly unique identifier

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Workspace not found
- `409` — Workspace slug already exists
- `500` — Internal server error

---

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