---
title: "Create a space"
method: POST
path: "/v2/spaces"
tags: ["Spaces"]
---

# Create a space

`POST /v2/spaces`

Create a new space within an organization.

**Payload Requirements**
- `name` and `organization_id` are required.
- The space name must be unique within the organization.
- `description` is optional and defaults to an empty string if omitted.
- System-managed fields (`id`, `created_at`) are generated
  automatically and rejected if provided.

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

## Request body

- CreateSpaceRequest
  - `name` string, required — Name of the space (must be unique within the organization)
  - `organization_id` string, required — A universally unique identifier (base64-encoded opaque string).
  - `description` string — A brief description of the space's purpose. Defaults to an empty string if omitted.
  - `is_private` boolean — Whether to create the space as private. Private spaces are only visible to their members and account/org/space admins. Defaults to `false` (public) if omitted.

## Response `201`

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