---
title: "Create a new workspace"
method: POST
path: "/workspaces"
tags: ["workspace"]
---

# Create a new workspace

`POST /workspaces`

## Request body

- ServerCreateWorkspaceRequest
  - `name` string

## Response `200`

OK

- ServerFetchWorkspaceResponse
  - `message` string, required
  - `workspace` MalakWorkspace, required
    - `created_at` string
    - `id` string
    - `metadata` MalakPlanMetadata
      - `deck` object
        - `count` integer
      - `team` object
        - `enabled` boolean
        - `size` integer
    - `plan_id` string
    - `reference` string
    - `stripe_customer_id` string — Not required Dummy values work really
    - `subscription_id` string
    - `updated_at` string
    - `workspace_name` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2024-12-24** `60bec59f1e00` — 1 info
  - added the optional property `workspace/metadata/deck` to the response with the `200` status
- **2024-11-14** `9eeda9b06388` — 6 warning, 2 info
  - removed the optional property `workspace/is_banned` from the response with the `200` status
  - removed the optional property `workspace/is_subscription_active` from the response with the `200` status
  - removed the optional property `workspace/logo_url` from the response with the `200` status
  - removed the optional property `workspace/plan` from the response with the `200` status
  - …4 more

[Change history](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation/changes/workspaces/post.md)

---

[API](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation.md) · [All operations](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ayinke-llc/malak-s-api-documentation/revisions/ab3daa8a3323/schema)