Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/anthropic-environments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Anthropic Environments API
version: '1.0'
description: 'Operations tagged Environments across 2 of this provider''s published API definitions: anthropic-api-openapi.json, anthropic-managed-agents-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.anthropic.com
tags:
- name: Environments
paths:
/v1/environments/{environment_id}/archive?beta=true:
post:
summary: Archive Environment
description: Archive an environment by ID. Archived environments cannot be used to create new sessions.
operationId: beta_archive_environment_v1_environments__environment_id__archive_post
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaEnvironment'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
servers:
- url: https://api.anthropic.com
/v1/environments/{environment_id}/work/poll?beta=true:
get:
summary: Poll for Work
description: 'Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Long poll for work items in the queue.'
operationId: beta_poll_work_v1_environments__environment_id__work_poll_get
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: block_ms
in: query
required: false
schema:
anyOf:
- type: integer
minimum: 1
- type: 'null'
description: How long to wait for work to arrive before returning. Must be 1-999 in milliseconds. Defaults to non-blocking (returns immediately if no work is available).
title: Block Ms
description: How long to wait for work to arrive before returning. Must be 1-999 in milliseconds. Defaults to non-blocking (returns immediately if no work is available).
- name: reclaim_older_than_ms
in: query
required: false
schema:
anyOf:
- type: integer
minimum: 1
- type: 'null'
description: Reclaim unacknowledged work items older than this many milliseconds. If omitted, uses the default (5000ms).
title: Reclaim Older Than Ms
description: Reclaim unacknowledged work items older than this many milliseconds. If omitted, uses the default (5000ms).
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: Anthropic-Worker-ID
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Unique identifier for the specific worker polling, used to track aggregated environment-level work metrics in Console
title: Anthropic-Worker-Id
description: Unique identifier for the specific worker polling, used to track aggregated environment-level work metrics in Console
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/BetaSelfHostedWork'
- type: 'null'
title: Response Poll Work V1 Environments Environment Id Work Poll Get
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
servers:
- url: https://api.anthropic.com
/v1/environments/{environment_id}/work/stats?beta=true:
get:
summary: Get Queue Statistics
description: Get statistics about the work queue for an environment.
operationId: beta_get_environment_stats_v1_environments__environment_id__work_stats_get
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWorkQueueStats'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
servers:
- url: https://api.anthropic.com
/v1/environments/{environment_id}/work/{work_id}/ack?beta=true:
post:
summary: Acknowledge Work
description: 'Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Acknowledge receipt of a work item, transitioning it from ''queued'' to ''starting'' and removing it from the queue.'
operationId: beta_acknowledge_work_v1_environments__environment_id__work__work_id__ack_post
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: work_id
in: path
required: true
schema:
type: string
title: Work Id
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWork'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
servers:
- url: https://api.anthropic.com
/v1/environments/{environment_id}/work/{work_id}/heartbeat?beta=true:
post:
summary: Record Heartbeat
description: 'Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Record a heartbeat for a work item to maintain the lease.'
operationId: beta_record_heartbeat_v1_environments__environment_id__work__work_id__heartbeat_post
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: work_id
in: path
required: true
schema:
type: string
title: Work Id
- name: desired_ttl_seconds
in: query
required: false
schema:
anyOf:
- type: integer
- type: 'null'
description: Desired TTL in seconds
title: Desired Ttl Seconds
description: Desired TTL in seconds
- name: expected_last_heartbeat
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Expected last_heartbeat for conditional update (optimistic concurrency). Use literal 'NO_HEARTBEAT' to claim an unclaimed lease (first heartbeat). For subsequent heartbeats, echo the server's previous last_heartbeat value exactly. Returns 412 Precondition Failed if the actual value doesn't match.
title: Expected Last Heartbeat
description: Expected last_heartbeat for conditional update (optimistic concurrency). Use literal 'NO_HEARTBEAT' to claim an unclaimed lease (first heartbeat). For subsequent heartbeats, echo the server's previous last_heartbeat value exactly. Returns 412 Precondition Failed if the actual value doesn't match.
examples:
first_claim:
summary: First heartbeat (claim unclaimed lease)
value: NO_HEARTBEAT
subsequent:
summary: Subsequent heartbeat (echo server's value)
value: '2026-05-14T10:30:45.123456Z'
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWorkHeartbeatResponse'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
servers:
- url: https://api.anthropic.com
/v1/environments/{environment_id}/work/{work_id}/stop?beta=true:
post:
summary: Stop Work
description: 'Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Stop a work item, initiating graceful or forced shutdown.'
operationId: beta_stop_work_v1_environments__environment_id__work__work_id__stop_post
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: work_id
in: path
required: true
schema:
type: string
title: Work Id
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWorkStopRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWork'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
servers:
- url: https://api.anthropic.com
/v1/environments/{environment_id}/work/{work_id}?beta=true:
get:
summary: Get Work Item
description: 'Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Retrieve detailed information about a specific work item.'
operationId: beta_get_work_v1_environments__environment_id__work__work_id__get
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: work_id
in: path
required: true
schema:
type: string
title: Work Id
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWork'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
post:
summary: Update Work Item
description: 'Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Update work item metadata with merge semantics.'
operationId: beta_update_work_v1_environments__environment_id__work__work_id__post
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: work_id
in: path
required: true
schema:
type: string
title: Work Id
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWorkUpdateRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWork'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
servers:
- url: https://api.anthropic.com
/v1/environments/{environment_id}/work?beta=true:
get:
summary: List Work Items
description: 'Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
List work items in an environment.'
operationId: beta_list_work_v1_environments__environment_id__work_get
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: limit
in: query
required: false
schema:
type: integer
maximum: 1000
minimum: 1
description: Maximum number of work items to return
default: 20
title: Limit
description: Maximum number of work items to return
- name: page
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Opaque cursor from previous response for pagination
x-stainless-pagination-property:
purpose: next_cursor_param
title: Page
description: Opaque cursor from previous response for pagination
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaSelfHostedWorkListResponse'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Environments
servers:
- url: https://api.anthropic.com
/v1/environments/{environment_id}?beta=true:
get:
summary: Get Environment
description: Retrieve a specific environment by ID.
operationId: beta_get_environment_v1_environments__environment_id__get
parameters:
- name: environment_id
in: path
required: true
schema:
type: string
title: Environment Id
example: env_011CZkZ9X2dpNyB7HsEFoRfW
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/openapi/anthropic-environments-api-openapi.yml