---
title: "POST /v1/spaces"
method: POST
path: "/v1/spaces"
---

# POST /v1/spaces

`POST /v1/spaces`

Retrieves a list of spaces.

## Request body

- object
  - `nextToken` string — A token returned from a call to this API to indicate the next batch of results to return, if any.

## Response `200`

Success

- ListSpacesResponse
  - `nextToken` string — A token returned from a call to this API to indicate the next batch of results to return, if any.
  - `items` SpaceSummary[] — Information about the spaces.
    - `name` string, required — The name of the space.
    - `regionName` string, required — The Amazon Web Services Region where the space exists.
    - `displayName` string — The friendly name of the space displayed to users.
    - `description` string — The description of the space.

## Other responses

- `480` — ThrottlingException
- `481` — ConflictException
- `482` — ValidationException
- `483` — ServiceQuotaExceededException
- `484` — ResourceNotFoundException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/codecatalyst.md) · [All operations](https://skmtc.net/aws/apis/codecatalyst/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/codecatalyst/versions/b82f5a10dc49/schema)