---
title: "POST /api/workspaces/"
method: POST
path: "/api/workspaces/"
tags: ["Workspaces"]
---

# POST /api/workspaces/

`POST /api/workspaces/`

Creates a new workspace where only the authorized user has access to. No initial data like database applications are added, they have to be created via other endpoints.

## Headers

- `ClientSessionId` string, uuid

## Request body

- Workspace
  - `id` integer, required
  - `name` string, required
  - `generative_ai_models_enabled` string, required

## Response `200`

- WorkspaceUserWorkspace — This serializers includes relevant fields of the Workspace model, but also some WorkspaceUser specific fields related to the workspace user relation. Additionally, the list of users are included for each workspace.
  - `id` integer, required — Workspace id.
  - `name` string, required — Workspace name.
  - `users` WorkspaceUser[], required — List of all workspace users.
    - `id` integer, required
    - `name` string, required — User defined name.
    - `email` string, required — User email.
    - `workspace` integer, required — The workspace that the user has access to.
    - `permissions` string — The permissions that the user has within the workspace.
    - `created_on` string, date-time, required
    - `user_id` integer, required — The user that has access to the workspace.
    - `to_be_deleted` boolean, required — True if user account is pending deletion.
    - `two_factor_auth` string, required
  - `order` integer, required — The requesting user's order within the workspace users.
  - `permissions` string, required — The requesting user's permissions for the workspace.
  - `unread_notifications_count` integer, required — The number of unread notifications for the requesting user.
  - `generative_ai_models_enabled` string, required — Generative AI models available in this workspace.

---

[API](https://skmtc.net/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.net/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/revisions/0c490e5b0c7f/schema)