Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Developer Platform 25 Aug 2026
One change · api

Create Environment changedapi/beta/environments/create

Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Recorded here
Lines+28added
Lines−45removed
From line 1 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits18to this page, all time

# Create Environment ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Create Environment ### Header Parameters ### Body Parameters ### Returns ### Example #### Response

The whole hunk

from line 1, old and new numbered
/
lines
from line 1
1---
2title: Create Environment
3url: https://platform.claude.com/docs/en/api/beta/environments/create
4---
1# Create Environment
52 
6## Create Environment
3**POST** `/v1/environments`
74 
8**post** `/v1/environments`
9 
105Create a new environment with the specified configuration.
116 
12### Header Parameters
7## Headers
138 
149- `"anthropic-beta": optional array of AnthropicBeta`
1510 
from line 82
8782 
8883 - `"mid-conversation-tool-changes-2026-07-01"`
8984 
90### Body Parameters
85## Body parameters
9186 
9287- `name: string`
9388 
9489 Human-readable name for the environment
9590 
91 maxLength: 256, minLength: 1
92 
9693- `config: optional BetaCloudConfigParams or BetaSelfHostedConfigParams or null`
9794 
9895 Environment configuration
9996 
100 - `BetaCloudConfigParams object { type, networking, packages }`
97 - `BetaCloudConfigParams object`
10198 
10299 Request params for `cloud` environment configuration.
103100 
from line 105
108105 
109106 Environment type
110107 
111 - `"cloud"`
112 
113108 - `networking: optional BetaUnrestrictedNetwork or BetaLimitedNetworkParams or null`
114109 
115110 Network configuration policy. Omit on update to preserve the existing value.
116111 
117 - `BetaUnrestrictedNetwork object { type }`
112 - `BetaUnrestrictedNetwork object`
118113 
119114 Unrestricted network access.
120115 
from line 117
122117 
123118 Network policy type
124119 
125 - `"unrestricted"`
120 - `BetaLimitedNetworkParams object`
126121 
127 - `BetaLimitedNetworkParams object { type, allow_mcp_servers, allow_package_managers, allowed_hosts }`
128 
129122 Limited network request params.
130123 
131124 Fields default to null; on update, omitted fields preserve the
from line 128
135128 
136129 Network policy type
137130 
138 - `"limited"`
139 
140131 - `allow_mcp_servers: optional boolean or null`
141132 
142133 Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. Defaults to `false`.
from line 174
183174 
184175 Package configuration type
185176 
186 - `"packages"`
177 default: packages
187178 
188 - `BetaSelfHostedConfigParams object { type }`
179 - `BetaSelfHostedConfigParams object`
189180 
190181 Request params for `self_hosted` environment configuration.
191182 
from line 184
193184 
194185 Environment type
195186 
196 - `"self_hosted"`
197 
198187- `description: optional string or null`
199188 
200189 Optional description of the environment
201190 
191 maxLength: 1024
192 
202193- `metadata: optional map[string]`
203194 
204195 User-provided metadata key-value pairs
from line 202
211202 
212203 - `"account"`
213204 
214### Returns
205## Returns
215206 
216- `BetaEnvironment object { id, archived_at, config, 7 more }`
207- `BetaEnvironment object`
217208 
218209 Unified Environment resource for both cloud and self-hosted environments.
219210 
from line 220
229220 
230221 Environment configuration (either Anthropic Cloud or self-hosted)
231222 
232 - `BetaCloudConfig object { networking, packages, type }`
223 - `BetaCloudConfig object`
233224 
234225 `cloud` environment configuration.
235226 
from line 228
237228 
238229 Network configuration policy.
239230 
240 - `BetaUnrestrictedNetwork object { type }`
231 - `BetaUnrestrictedNetwork object`
241232 
242233 Unrestricted network access.
243234 
from line 236
245236 
246237 Network policy type
247238 
248 - `"unrestricted"`
239 - `BetaLimitedNetwork object`
249240 
250 - `BetaLimitedNetwork object { allow_mcp_servers, allow_package_managers, allowed_hosts, type }`
251 
252241 Limited network access.
253242 
254243 - `allow_mcp_servers: boolean`
from line 256
267256 
268257 Network policy type
269258 
270 - `"limited"`
271 
272259 - `packages: BetaPackages`
273260 
274261 Package manager configuration.
from line 288
301288 
302289 Package configuration type
303290 
304 - `"packages"`
291 default: packages
305292 
306293 - `type: "cloud"`
307294 
308295 Environment type
309296 
310 - `"cloud"`
297 - `BetaSelfHostedConfig object`
311298 
312 - `BetaSelfHostedConfig object { type }`
313 
314299 Configuration for self-hosted environments.
315300 
316301 - `type: "self_hosted"`
from line 302
317302 
318303 Environment type
319304 
320 - `"self_hosted"`
321 
322305 - `created_at: string`
323306 
324307 RFC 3339 timestamp when environment was created
from line 322
339322 
340323 The type of object (always 'environment')
341324 
342 - `"environment"`
325 default: environment
343326 
344327 - `updated_at: string`
345328 
from line 336
353336 
354337 - `"account"`
355338 
356### Example
339## Example
357340 
358```http
341```bash
359342curl https://api.anthropic.com/v1/environments \
360343 -H 'Content-Type: application/json' \
361344 -H 'anthropic-version: 2023-06-01' \
from line 366
383366 }'
384367```
385368 
386#### Response
369### Response (200)
387370 
388371```json
389372{
Feedback