---
title: "Create Workspace"
method: POST
path: "/api/v1/workspaces"
tags: ["workspaces"]
---

# Create Workspace

`POST /api/v1/workspaces`

Creates a workspace based on the requestBody.

# noqa: DAR401

Args:
    workspace: Workspace to create.

Returns:
    The created workspace.

## Request body

- WorkspaceRequest — Request model for workspaces.
  - `name` string, required
  - `description` string

## Response `200`

Successful Response

- WorkspaceResponse — Response model for workspaces.
  - `body` WorkspaceResponseBody — Response body for workspaces.
    - `created` string, date-time, required
    - `updated` string, date-time, required
  - `metadata` WorkspaceResponseMetadata — Response metadata for workspaces.
    - `description` string
  - `resources` WorkspaceResponseResources — Class for all resource models associated with the workspace entity.
  - `id` string, uuid, required
  - `permission_denied` boolean
  - `name` string, required

## Other responses

- `401` — Unauthorized
- `409` — Conflict
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/zenml-io/apis/zenml-2.md) · [All operations](https://skmtc.net/zenml-io/apis/zenml-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zenml-io/zenml-2/versions/febb01b8bce3/schema)