---
title: "POST /v1/spaces/{spaceName}/projects"
method: POST
path: "/v1/spaces/{spaceName}/projects"
---

# POST /v1/spaces/{spaceName}/projects

`POST /v1/spaces/{spaceName}/projects`

Retrieves a list of projects.

## Path parameters

- `spaceName` string, required

## 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.
  - `maxResults` integer — The maximum number of results to show in a single call to this API. If the number of results is larger than the number you specified, the response will include a <code>NextToken</code> element, which you can use to obtain additional results.
  - `filters` ProjectListFilter[] — Information about filters to apply to narrow the results returned in the list.
    - `key` 'hasAccessTo' | 'name', required — A key that can be used to sort results.
    - `values` String[], required — The values of the key.
    - `comparisonOperator` 'EQ' | 'GT' | 'GE' | 'LT' | 'LE' | 'BEGINS_WITH' — The operator used to compare the fields.

## Response `200`

Success

- ListProjectsResponse
  - `nextToken` string — A token returned from a call to this API to indicate the next batch of results to return, if any.
  - `items` ProjectSummary[] — Information about the projects.
    - `name` string, required — The name of the project in the space.
    - `displayName` string — The friendly name displayed to users of the project in Amazon CodeCatalyst.
    - `description` string — The description of the project.

## 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)