---
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, required
  - `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
  - `users` WorkspaceUserResponse[]
    - `user_ext_id` string, required
    - `email` string, required
    - `name` string, required
    - `last_name` string, required

## Other responses

- `422` — Validation Error

## Changes

- **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/2cd7c0e6303a/schema)