---
title: "Create a Collection"
method: POST
path: "/{workspace}/spaces"
---

# Create a Collection

`POST /{workspace}/spaces`

## Request

- Base URL: `https://modeanalytics.com/api`
- URL: `https://modeanalytics.com/api/{workspace}/spaces`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/thoughtspot/apis/mode/docs/:workspace/spaces/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a `Collection`

## Path parameters

- `workspace` string, required

## Request body

- CreateOrUpdateSpaceRequestBody
  - `space` object, required: The parameters of the new or updated space
    - `description` string: Description of the `space`
    - `name` string, required: Name of the `space`

## Response `200`

`Space` response

- Space
  - `token` string, required
  - `id` integer, required
  - `space_type` string, required
  - `name` string, required
  - `description` string, required
  - `state` string, required
  - `restricted` boolean, required
  - `free_default` string, required
  - `viewable?` string, required
  - `viewed?` string
  - `default_access_level` string
  - `_links` SpaceLinks, required
    - `self` Link, required
      - `href` string, required
      - `templated` boolean
    - `detail` Link, required
      - `href` string, required
      - `templated` boolean
    - `space_report_pins` Link
      - `href` string, required
      - `templated` boolean
    - `web` Link
      - `href` string, required
      - `templated` boolean
    - `reports` Link, required
      - `href` string, required
      - `templated` boolean
    - `creator` Link
      - `href` string, required
      - `templated` boolean
    - `user_space_membership` Link
      - `href` string, required
      - `templated` boolean
    - `space_memberships` Link
      - `href` string, required
      - `templated` boolean
    - `preview_space_memberships` Link
      - `href` string, required
      - `templated` boolean
    - `search_space_permissions` Link, required
      - `href` string, required
      - `templated` boolean
    - `viewed` Link
      - `href` string, required
      - `templated` boolean
  - `_embedded` unknown

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: `Account` not found

---

[API](https://skmtc.dev/thoughtspot/apis/mode.md) - [All operations](https://skmtc.dev/thoughtspot/apis/mode/llms.txt) - [OpenAPI document](https://skmtc.dev/thoughtspot/apis/mode/revisions/4c694c3fdeb1?raw)