---
title: "GET /workspaces"
method: GET
path: "/workspaces"
---

# GET /workspaces

`GET /workspaces`

Lists all AMP workspaces, including workspaces being created or deleted.

## Query parameters

- `alias` string — A user-assigned workspace alias.
- `maxResults` integer
- `nextToken` string — A token used to access the next page in a paginated result set.

## Response `200`

Success

- ListWorkspacesResponse — Represents the output of a ListWorkspaces operation.
  - `nextToken` string — Pagination token to use when requesting the next page in this list.
  - `workspaces` WorkspaceSummary[], required — The list of existing workspaces, including those undergoing creation or deletion.
    - `alias` string — Alias of this workspace.
    - `arn` string, required — The AmazonResourceName of this workspace.
    - `createdAt` string, date-time, required — The time when the workspace was created.
    - `status` object, required — The status of this workspace.
      - `statusCode` 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'CREATION_FAILED', required — Status code of this workspace.
    - `tags` object — The tags of this workspace.
    - `workspaceId` string, required — Unique string identifying this workspace.

## Other responses

- `480` — ThrottlingException
- `481` — ValidationException
- `482` — AccessDeniedException
- `483` — InternalServerException

---

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