---
title: "Create workspace"
method: POST
path: "/v1/workspaces"
tags: ["Workspaces"]
---

# Create workspace

`POST /v1/workspaces`

Create a new workspace and assign creator as owner

## Request body

- CreateWorkspaceRequest
  - `name` string, required — Display name of the workspace
  - `slug` string, required — URL-friendly unique identifier (lowercase, no spaces)

## Response `201`

Workspace created successfully

- Workspace
  - `awsRoleArn` string, nullable — AWS IAM role ARN for integrations
  - `createdAt` string, date-time, required — Timestamp when workspace was created
  - `googleServiceAccountEmail` string, email, nullable — Google service account email for integrations
  - `id` string, uuid, required — Unique identifier for the workspace
  - `name` string, required — Display name of the workspace
  - `slug` string, required — URL-friendly unique identifier

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `409` — Workspace slug already exists
- `500` — Internal server error

---

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