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

# POST /workspaces

`POST /workspaces`

Creates a new AMP workspace.

## Request body

- object
  - `alias` string — A user-assigned workspace alias.
  - `clientToken` string — An identifier used to ensure the idempotency of a write request.
  - `tags` object — The list of tags assigned to the resource.

## Response `202`

Success

- CreateWorkspaceResponse — Represents the output of a CreateWorkspace operation.
  - `arn` string, required — The ARN of the workspace that was just created.
  - `status` object, required — The status of the workspace that was just created (usually CREATING).
    - `statusCode` 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'CREATION_FAILED', required — Status code of this workspace.
  - `tags` object — The tags of this workspace.
  - `workspaceId` string, required — The generated ID of the workspace that was just created.

## Other responses

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

---

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