curl -X POST 'https://api.anthropic.com/v1/organizations/workspaces?beta=true' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "example-name"
}'

# POST /v1/organizations/workspaces?beta=true (Claude API)
Base URL: https://api.anthropic.com
Auth: x-api-key; Anthropic API key; required.
Status: Beta.
Request formats: application/json.
Last verified: 2026-10-20

> Create Workspace

## Critical Gotchas
* Authentication uses the `x-api-key` header and requests also require an `anthropic-version` header.
* The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

## cURL
curl -X POST 'https://api.anthropic.com/v1/organizations/workspaces?beta=true' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "example-name"
}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | Name of the Workspace. |
| data_residency | body | object | No | Data residency configuration for the workspace. If omitted, defaults to `work... |
| display_color | body | string | No | Hex color code representing the Workspace in the Anthropic Console. |
| external_key_id | body | string | No | ID of the customer-managed encryption key (CMEK) configuration to use for thi... |
| tags | body | object | No | User-defined tags as string key-value pairs. Keys may not begin with `anthrop... |

## Response example
{"archived_at":"2026-09-03T00:00:00Z","compartment_id":"string"}

---
Need an API key? Get one at https://console.anthropic.com/settings/keys

POST

POST /v1/organizations/workspaces?beta=true — Claude API

Beta

Anthropic API key (required); https://api.anthropic.com

Claude API

Create Workspace

Base URL: https://api.anthropic.com
Auth: x-api-key: <ANTHROPIC_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 289 tokens · Vary: Accept

Critical gotchas

Authentication uses the x-api-key header and requests also require an anthropic-version header.

The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

cURL

curl -X POST 'https://api.anthropic.com/v1/organizations/workspaces?beta=true' \  -H "x-api-key: $ANTHROPIC_API_KEY" \  -H 'anthropic-version: 2023-06-01' \  -H 'Content-Type: application/json' \  -d '{  "name": "example-name"}'

Parameters

Name	In	Type	Required	Description
data_residency	body	object	No	Data residency configuration for the workspace. If omitted, defaults to `workspace_geo: "us"`, `allowed_inference_geos: "unrestricted"`, and `default_inference_geo: "global"`.
display_color	body	string	No	Hex color code representing the Workspace in the Anthropic Console.
external_key_id	body	string	No	ID of the customer-managed encryption key (CMEK) configuration to use for this Workspace. Setting this field requires CMEK to be enabled for your organization. When set, data stored for this Workspace is encrypted with the referenced key. Create key configurations with the External Keys API. On Claude Platform on AWS the value is the AWS KMS key ARN, and the key must be a single-Region key in the same AWS account and Region as the Workspace. On that platform the key is validated against this Workspace when it is attached, so a key-policy problem is reported as an error on this request. This field is write-once: once a key is attached to a Workspace it cannot be detached or replaced. To rotate key material, rotate the underlying key on your cloud KMS; the `external_key_id` stays the same.
name	body	string	Yes	Name of the Workspace.
tags	body	object	No	User-defined tags as string key-value pairs. Keys may not begin with `anthropic`.

Response 200 OK

{
  "archived_at": "2026-09-03T00:00:00Z",
  "compartment_id": "string",
  "created_at": "2026-09-03T00:00:00Z",
  "data_residency": {
    "allowed_inference_geos": [
      "string"
    ],
    "default_inference_geo": "string",
    "workspace_geo": "string"
  },
  "display_color": "string",
  "external_key_id": "string",
  "id": "string",
  "name": "string",
  "tags": {},
  "type": "workspace"
}

Get a free Claude API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.