---
title: "Update a workspace"
method: PATCH
path: "/v2/workspaces/{key}"
tags: ["Workspaces"]
---

# Update a workspace

`PATCH /v2/workspaces/{key}`

Partially updates a workspace. Omit a field to leave it unchanged. Set `archived` to true to archive, false to restore. The workspace key cannot be changed.

## Path parameters

- `key` string, required

## Request body

- UpdateWorkspaceRequest
  - `display_name` string
  - `logo_url` string
  - `archived` boolean
  - `settings` WorkspaceSettingsFields
    - `same_project_entities_enabled` boolean
    - `model_garden_settings` object
    - `plugins` object
  - `metadata` object
  - `enforce_enabled_models` boolean
  - `chat_kit` ChatKitResources
    - `items` ChatKitResource[]
      - `id` string
      - `display_name` string
      - `resource_id` string
      - `resource_type` string

## Response `200`

OK

- UpdateWorkspaceResponse
  - `workspace` Workspace, required
    - `id` string, required
    - `key` string, required
    - `display_name` string, required
    - `logo_url` string
    - `archived_on` string, date-time
    - `archived_by_id` string
    - `organization` WorkspaceOrganization
      - `id` string
      - `key` string
    - `settings` WorkspaceSettingsFields
      - `same_project_entities_enabled` boolean
      - `model_garden_settings` object
      - `plugins` object
    - `sidebar_version` string
    - `features` object
    - `total_members` integer
    - `metadata` object
    - `capabilities` WorkspaceCapabilities
      - `roles` string[]
      - `projects` string[]

## Changes

> 350 revisions in range; 136 not diffed.

- **2026-09-07** `bcd6172f8655` — 1 info
  - endpoint added
- **2026-09-07** `dcc0afb98a48` — 1 breaking
  - api path removed without deprecation
- **2026-09-06** `e1a2869bc12f` — 1 info
  - endpoint added
- **2026-09-06** `28c58af69b8c` — 1 breaking
  - api path removed without deprecation
- **2026-09-04** `bd22332086ec` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/workspaces/:key/patch.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/3c7d859558ee?raw)