---
title: "GET /workspaces/{workspaceId}"
method: GET
path: "/workspaces/{workspaceId}"
---

# GET /workspaces/{workspaceId}

`GET /workspaces/{workspaceId}`

Describes an existing AMP workspace.

## Path parameters

- `workspaceId` string, required — A workspace ID.

## Response `200`

Success

- DescribeWorkspaceResponse — Represents the output of a DescribeWorkspace operation.
  - `workspace` object, required — The properties of the selected workspace.
    - `alias` string — Alias of this workspace.
    - `arn` string, required — The Amazon Resource Name (ARN) of this workspace.
    - `createdAt` string, date-time, required — The time when the workspace was created.
    - `prometheusEndpoint` string — Prometheus endpoint URI.
    - `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` — ResourceNotFoundException
- `483` — AccessDeniedException
- `484` — 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)