---
title: "POST /accounts/workspaces/{workspace_id}/"
method: POST
path: "/accounts/workspaces/{workspace_id}/"
tags: ["accounts"]
---

# POST /accounts/workspaces/{workspace_id}/

`POST /accounts/workspaces/{workspace_id}/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/accounts/workspaces/{workspace_id}/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Create a new workspace

## Request body

- WorkspaceCreateRequest
  - `name` string, required
  - `display_name` string
  - `description` string
  - `emails` string[]
  - `role` string

## Response `201`

Created

- WorkspaceCreateResponse
  - `status` boolean, required
  - `result` WorkspaceCreateResult, required
    - `workspace` WorkspaceSummary, required
      - `id` string, uuid, required
      - `name` string, required
      - `display_name` string, required
      - `description` string
      - `is_default` boolean
    - `message` string, required
    - `added_users` string[], required
    - `created_users` string[], required
    - `total_users_added` integer, required
    - `total_users_created` integer, required
    - `failed_users` WorkspaceCreateUserError[], required
      - `email` string, email, required
      - `error` string, required
    - `other_org_users` WorkspaceCreateUserError[], required
      - `email` string, email, required
      - `error` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)