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

# POST /v1/environments/{environment_id}?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

> Update Environment

## 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/environments/environment-id?beta=true' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| environment_id | path | string | Yes | path parameter environment_id. |
| config | body | object | No | Updated environment configuration |
| description | body | string | No | Updated description of the environment. Omit to preserve; null clears to null... |
| metadata | body | object | No | User-provided metadata key-value pairs. Set a value to null or empty string t... |
| name | body | string | No | Updated name for the environment |
| scope | body | string | No | The visibility scope for this environment. 'organization' makes the environme... |

## Response example
{"type":"environment","id":"env_011CZkZ9X2dpNyB7HsEFoRfW"}

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

POST

POST /v1/environments/{environment_id}?beta=true — Claude API

Beta

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

Claude API

Update Environment

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
→ 294 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/environments/environment-id?beta=true' \  -H "x-api-key: $ANTHROPIC_API_KEY" \  -H 'anthropic-version: 2023-06-01' \  -H 'Content-Type: application/json' \  -d '{}'

Parameters

Name	In	Type	Required	Description
environment_id	path	string	Yes	path parameter environment_id.
config	body	object	No	Updated environment configuration
description	body	string	No	Updated description of the environment. Omit to preserve; null clears to null; an empty string is stored as an empty string.
metadata	body	object	No	User-provided metadata key-value pairs. Set a value to null or empty string to delete the key.
name	body	string	No	Updated name for the environment
scope	body	string	No	The visibility scope for this environment. 'organization' makes the environment visible to all accounts. 'account' restricts visibility to the owning account only.

Response 200 OK

{
  "type": "environment",
  "id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
  "name": "python-data-analysis",
  "description": "Python environment with data-analysis packages.",
  "config": {
    "type": "cloud",
    "networking": {
      "type": "limited",
      "allowed_hosts": [
        "api.example.com"
      ],
      "allow_package_managers": true,
      "allow_mcp_servers": false
    },
    "packages": {
      "type": "packages",
      "pip": [
        "pandas",
        "numpy"
      ],
      "npm": [],
      "apt": [],
      "cargo": [],
      "gem": [],
      "go": []
    }
  },
  "metadata": {},
  "archived_at": null,
  "created_at": "2026-03-15T10:00:00Z",
  "updated_at": "2026-03-15T10:00:00Z"
}

Get a free Claude API key → sponsored

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