---
title: "PUT /api/ee/workspace/{ws-id}"
method: PUT
path: "/api/ee/workspace/{ws-id}"
tags: ["/api/ee/workspace"]
---

# PUT /api/ee/workspace/{ws-id}

`PUT /api/ee/workspace/{ws-id}`

Update simple workspace properties.

  Can set database_id only on uninitialized workspaces.

## Path parameters

- `ws-id` integer, required

## Request body

- object
  - `database_id` integer — value must be an integer greater than zero.
  - `name` string

## Response `2XX`

Successful response

- object
  - `api_key` string
  - `collection_id` integer, required — value must be an integer greater than zero.
  - `created_at` string, date-time, required
  - `database_id` integer, required — value must be an integer greater than zero.
  - `id` integer, required — value must be an integer greater than zero.
  - `name` string, required
  - `status` 'archived' | 'ready' | 'broken' | 'pending' | 'uninitialized', required
  - `updated_at` string, date-time, required

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

## Changes

- **2026-03-09** `78297d193ca4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/ee/workspace/:ws-id/put.md)

---

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