---
title: "Update a space"
method: PATCH
path: "/v2/spaces/{space_id}"
tags: ["Spaces"]
---

# Update a space

`PATCH /v2/spaces/{space_id}`

Update a space's metadata by its ID. At least one field must be provided.

**Payload Requirements**
- At least one of `name`, `description`, or `is_private` must be provided.
- If `name` is provided, it must be unique within the organization.
- System-managed fields (`id`, `created_at`) cannot be modified.

<Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note>

## Path parameters

- `space_id` string, required — A universally unique identifier (base64-encoded opaque string).

## Request body

- UpdateSpaceRequest
  - `name` string — Updated name of the space
  - `description` string, nullable — Updated description of the space. Set to `null` to clear it.
  - `is_private` boolean — Updated visibility for the space. Set to `true` to make the space private (visible only to members and admins), or `false` to make it public. When omitted, the existing visibility is preserved.

## Response `200`

A space object

- Space — A space is a container within an organization for grouping related projects, datasets, and experiments. Spaces enable team collaboration or isolated experimentation with role-based access control.
  - `id` string, required — Unique identifier for the space
  - `name` string, required — Name of the space
  - `description` string, required — A brief description of the space's purpose
  - `created_at` string, date-time, required — Timestamp for when the space was created
  - `is_private` boolean, required — Whether the space is private. Private spaces are only visible to their members and account/org/space admins.

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `403` — Insufficient permissions to access this resource
- `404` — Not found
- `409` — Resource conflict
- `422` — Unprocessable entity
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/arize-ai/apis/arize-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-rest-api/versions/1e87d8a4cf69/schema)