환경

환경 생성

BetaEnvironment Beta.Environments.Create(parameters, cancellationToken = default)

POST/v1/environments

지정된 구성으로 새 환경을 생성합니다.

환경 목록 조회

EnvironmentListPage Beta.Environments.List(parameters, cancellationToken = default)

GET/v1/environments

페이지네이션을 지원하는 환경 목록을 조회합니다.

환경 조회

BetaEnvironment Beta.Environments.Retrieve(parameters, cancellationToken = default)

GET/v1/environments/{environment_id}

ID로 특정 환경을 조회합니다.

환경 업데이트

BetaEnvironment Beta.Environments.Update(parameters, cancellationToken = default)

POST/v1/environments/{environment_id}

기존 환경의 구성을 업데이트합니다.

환경 삭제

BetaEnvironmentDeleteResponse Beta.Environments.Delete(parameters, cancellationToken = default)

DELETE/v1/environments/{environment_id}

ID로 환경을 삭제합니다. 삭제 확인을 반환합니다.

환경 보관

BetaEnvironment Beta.Environments.Archive(parameters, cancellationToken = default)

POST/v1/environments/{environment_id}/archive

ID로 환경을 보관합니다. 보관된 환경은 새 세션을 생성하는 데 사용할 수 없습니다.

Models

class BetaCloudConfig { Type = "cloud"; Networking; Packages; }

cloud environment configuration.

class BetaCloudConfigParams { Type = "cloud"; Networking; Packages; }

Request params for cloud environment configuration.

Fields default to null; on update, omitted fields preserve the existing value.

class BetaEnvironment { Type = "environment"; ID; ArchivedAt; /* 7 more */ }

Unified Environment resource for both cloud and self-hosted environments.

class BetaEnvironmentDeleteResponse { Type; ID; }

Response after deleting an environment.

required Type Type

The type of response

required string ID

Environment identifier

class BetaLimitedNetwork { Type = "limited"; AllowMcpServers; AllowPackageManagers; AllowedHosts; }

Limited network access.

JsonElement Type = "limited"

Network policy type

required bool AllowMcpServers

Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the allowed_hosts array.

required bool AllowPackageManagers

Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the allowed_hosts array.

required IReadOnlyList<string> AllowedHosts

Specifies domains the container can reach.

class BetaLimitedNetworkParams { Type = "limited"; AllowMcpServers; AllowPackageManagers; AllowedHosts; }

Limited network request params.

Fields default to null; on update, omitted fields preserve the existing value.

JsonElement Type = "limited"

Network policy type

bool? AllowMcpServers

Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the allowed_hosts array. Defaults to false.

bool? AllowPackageManagers

Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the allowed_hosts array. Defaults to false on creation. Must be true when packages are specified.

IReadOnlyList<string>? AllowedHosts

Specifies domains the container can reach.

class BetaPackages { Type; Apt; Cargo; /* 4 more */ }

Packages (and their versions) available in this environment.

Type Type

Package configuration type

required IReadOnlyList<string> Apt

Ubuntu/Debian packages to install

required IReadOnlyList<string> Cargo

Rust packages to install

required IReadOnlyList<string> Gem

Ruby packages to install

required IReadOnlyList<string> Go

Go packages to install

required IReadOnlyList<string> Npm

Node.js packages to install

required IReadOnlyList<string> Pip

Python packages to install

class BetaPackagesParams { Type; Apt; Cargo; /* 4 more */ }

Specify packages (and optionally their versions) available in this environment.

When versioning, use the version semantics relevant for the package manager, e.g. for pip use package==1.0.0. You are responsible for validating the package and version exist. Unversioned installs the latest.

Under limited networking, requires networking.allow_package_managers to be true.

Type Type

Package configuration type

IReadOnlyList<string>? Apt

Ubuntu/Debian packages to install

IReadOnlyList<string>? Cargo

Rust packages to install

IReadOnlyList<string>? Gem

Ruby packages to install

IReadOnlyList<string>? Go

Go packages to install

IReadOnlyList<string>? Npm

Node.js packages to install

IReadOnlyList<string>? Pip

Python packages to install

class BetaSelfHostedConfig { Type = "self_hosted"; }

Configuration for self-hosted environments.

JsonElement Type = "self_hosted"

Environment type

class BetaSelfHostedConfigParams { Type = "self_hosted"; }

Request params for self_hosted environment configuration.

JsonElement Type = "self_hosted"

Environment type

class BetaUnrestrictedNetwork { Type = "unrestricted"; }

Unrestricted network access.

JsonElement Type = "unrestricted"

Network policy type

환경작업

작업 항목 조회

BetaSelfHostedWork Beta.Environments.Work.Retrieve(parameters, cancellationToken = default)

GET/v1/environments/{environment_id}/work/{work_id}

참고: 이 엔드포인트는 자체 호스팅 샌드박스 환경에서 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공하는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

작업 폴링

BetaSelfHostedWork? Beta.Environments.Work.Poll(parameters, cancellationToken = default)

GET/v1/environments/{environment_id}/work/poll

작업 확인

BetaSelfHostedWork Beta.Environments.Work.Ack(parameters, cancellationToken = default)

POST/v1/environments/{environment_id}/work/{work_id}/ack

참고: 이러한 엔드포인트는 자체 호스팅 샌드박스 환경과의 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공되는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

환경의 작업 큐에 대한 통계를 가져옵니다.

환경

환경 생성

환경 목록 조회

환경 조회

환경 업데이트

환경 삭제

환경 보관

Models

환경작업

작업 항목 조회

작업 폴링

작업 확인

하트비트 기록

작업 중지

작업 항목 나열

작업 항목 업데이트

큐 통계 가져오기

환경

Models

환경작업

환경작업