---
title: "Create a Workspace in the specified Organization"
method: POST
path: "/v1/organizations/{organizationId}/workspaces"
tags: ["workspaces"]
---

# Create a Workspace in the specified Organization

`POST /v1/organizations/{organizationId}/workspaces`

Create a new Workspace in the specified Organization.

## Path parameters

- `organizationId` string, required

## Request body

- WorkspaceCreateRequestDTO
  - `workspaceId` string, required — Unique identifier for the Workspace.
  - `alias` string — User-friendly alias for the Workspace.
  - `description` string — Brief description of the Workspace.
  - `tags` string[] — Tags associated with the Workspace.

## Response `201`

The Workspace has been successfully created

- WorkspaceSchema
  - `workspaceId` string, required — Unique identifier for the Workspace.
  - `region` 'us-west-2' | 'us-east-1' | 'us-east-2' | 'eu-central-1' | 'eu-central-2' | 'eu-west-2' | 'ap-southeast-1' | 'ap-southeast-2' | 'ca-central-1' | 'ap-northeast-1' | 'sa-east-1' | 'eu-west-1' | 'eu-west-3', required — AWS region where the Workspace is deployed.
  - `leaderFQDN` string, required — Fully Qualified Domain Name (FQDN) of the Workspace Leader.
  - `state` 'Provisioning' | 'Active' | 'Inactive' | 'Failed' | 'Deprovisioning', required — Current state of the Workspace.
  - `alias` string — User-friendly alias for the Workspace.
  - `description` string — Brief description of the Workspace.
  - `tags` string[] — Tags associated with the Workspace.

## Other responses

- `default` — Default error response

## Changes

- **2026-03-04** `bfa460b2aec3` — 3 warning
  - the `alias` request property's maxLength was set to `30`
  - the `description` request property's maxLength was set to `255`
  - the `tags/items/` request property's maxLength was set to `30`
- **2026-03-04** `9bda0eaca345` — 4 warning
  - added the new `ap-northeast-1` enum value to the `region/allOf[#/components/schemas/AWSRegions]/` response property for the response status `201`
  - added the new `eu-west-1` enum value to the `region/allOf[#/components/schemas/AWSRegions]/` response property for the response status `201`
  - added the new `eu-west-3` enum value to the `region/allOf[#/components/schemas/AWSRegions]/` response property for the response status `201`
  - added the new `sa-east-1` enum value to the `region/allOf[#/components/schemas/AWSRegions]/` response property for the response status `201`
- **2025-10-23** `1ab82a0cc26d` — 1 breaking
  - removed the required property `lastUpdated` from the response with the `201` status
- **2025-10-10** `0d907f2a3696` — 1 info
  - removed the non-success response with the status `500`
- …earlier changes not shown

[Full history](https://skmtc.dev/criblio/apis/cribl-cloud-public-api/changes/v1/organizations/:organizationId/workspaces/post.md)

---

[API](https://skmtc.dev/criblio/apis/cribl-cloud-public-api.md) · [All operations](https://skmtc.dev/criblio/apis/cribl-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/criblio/cribl-cloud-public-api/revisions/33ff494592e1/schema)