---
title: "Update Workspace"
method: PATCH
path: "/api/workspace/{workspace_ext_id}"
tags: ["workspace"]
---

# Update Workspace

`PATCH /api/workspace/{workspace_ext_id}`

Update workspace metadata such as name, description, or public status.
Changes are persisted to the database.

Only developers can change the is_public field.
When making a workspace public, the backend uses the Workspace-Key header to get the workspace key.

## Path parameters

- `workspace_ext_id` string, required

## Headers

- `workspace-key` string

## Request body

- WorkspaceUpdateRequest
  - `name` string, nullable
  - `description` string, nullable
  - `is_public` boolean, nullable

## Response `200`

Successful Response

- WorkspaceResponse
  - `external_id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `is_public` boolean, required
  - `created_by_ext_id` string, required
  - `updated_by_ext_id` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `wrapped_key` string, nullable
  - `shared_conversation_count` integer
  - `private_conversation_count` integer
  - `shared_document_count` integer
  - `private_document_count` integer
  - `user_files_mb` number
  - `users` UserResponse[]
    - `external_id` string, required
    - `email` string, required
    - `given_name` string, required
    - `family_name` string, required
    - `picture` string, nullable
    - `encryption_public_key` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2025-12-25** `aa4b06f8dede` — 4 breaking, 5 info
  - the response property `updated_by_ext_id` became optional for the status `200`
  - removed the required property `users/items/last_name` from the response with the `200` status
  - removed the required property `users/items/name` from the response with the `200` status
  - removed the required property `users/items/user_ext_id` from the response with the `200` status
  - …5 more
- **2025-11-03** `d6c3e911a263` — 1 info
  - added the optional property `user_files_mb` to the response with the `200` status
- **2025-10-28** `849d5e8732f6` — 7 info
  - added the new optional `header` request parameter `workspace-key`
  - added the optional property `private_conversation_count` to the response with the `200` status
  - added the optional property `private_document_count` to the response with the `200` status
  - added the optional property `shared_conversation_count` to the response with the `200` status
  - …3 more
- **2025-10-13** `5ab425658de0` — 2 info
  - added the new optional request property `is_public`
  - added the required property `is_public` to the response with the `200` status

[Change history](https://skmtc.dev/arbicity/apis/arbi/changes/api/workspace/:workspace_ext_id/patch.md)

---

[API](https://skmtc.dev/arbicity/apis/arbi.md) · [All operations](https://skmtc.dev/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arbicity/arbi/revisions/aa4b06f8dede/schema)