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

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

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

Retrieves a list of Dev Environments in a project.

## Path parameters

- `spaceName` string, required

## Request body

- object
  - `projectName` string — The name of the project in the space.
  - `filters` Filter[] — Information about filters to apply to narrow the results returned in the list.
    - `key` string, required — A key that can be used to sort results.
    - `values` String[], required — The values of the key.
    - `comparisonOperator` string — The operator used to compare the fields.
  - `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.

## Response `200`

Success

- ListDevEnvironmentsResponse
  - `items` DevEnvironmentSummary[], required — Information about the Dev Environments in a project.
    - `spaceName` string — The name of the space.
    - `projectName` string — The name of the project in the space.
    - `id` string, required — The system-generated unique ID for the Dev Environment.
    - `lastUpdatedTime` string, date-time, required — The time when the Dev Environment was last updated, in coordinated universal time (UTC) timestamp format as specified in <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC 3339</a>.
    - `creatorId` string, required — The system-generated unique ID of the user who created the Dev Environment.
    - `status` 'PENDING' | 'RUNNING' | 'STARTING' | 'STOPPING' | 'STOPPED' | 'FAILED' | 'DELETING' | 'DELETED', required — The status of the Dev Environment.
    - `statusReason` string — The reason for the status.
    - `repositories` DevEnvironmentRepositorySummary[], required — Information about the repositories that will be cloned into the Dev Environment. If no rvalue is specified, no repository is cloned.
      - `repositoryName` string, required — The name of the source repository.
      - `branchName` string — The name of the branch in a source repository cloned into the Dev Environment.
    - `alias` string — The user-specified alias for the Dev Environment.
    - `ides` Ide[] — Information about the integrated development environment (IDE) configured for a Dev Environment.
      - `runtime` string — A link to the IDE runtime image.
      - `name` string — The name of the IDE.
    - `instanceType` 'dev.standard1.small' | 'dev.standard1.medium' | 'dev.standard1.large' | 'dev.standard1.xlarge', required — The Amazon EC2 instace type used for the Dev Environment.
    - `inactivityTimeoutMinutes` integer, required — The amount of time the Dev Environment will run without any activity detected before stopping, in minutes. Dev Environments consume compute minutes when running.
    - `persistentStorage` object, required — Information about the configuration of persistent storage for the Dev Environment.
      - `sizeInGiB` integer, required — <p>The size of the persistent storage in gigabytes (specifically GiB).</p> <note> <p>Valid values for storage are based on memory sizes in 16GB increments. Valid values are 16, 32, and 64.</p> </note>
    - `vpcConnectionName` string — The name of the connection used to connect to Amazon VPC used when the Dev Environment was created, if any.
  - `nextToken` string — A token returned from a call to this API to indicate the next batch of results to return, if any.

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