A runtime environment defines the execution sandbox and pre-installed dependencies used for tool calls. Environments are managed independently of agents and can be reused across sessions.
Lifecycle
-
The update endpoint uses full-replacement semantics; omitted fields are cleared. Running sessions bound to this environment use the snapshot captured at bind time and are unaffected by updates.
-
Archive is a soft operation:
archived_atis set to the archive time. Archived environments are hidden from list results by default but can still be queried; bound sessions continue to work. -
Delete is a hard operation; environment configuration is removed and cannot be recovered.
Environment operations
|
Operation |
Endpoint |
Description |
|
|
Create a runtime environment; specify sandbox type and pre-installed dependencies. |
|
|
|
Get environment details. |
|
|
|
Paginated list of environments under the workspace; archived environments are excluded by default. |
|
|
|
Full-replacement update; running sessions use the snapshot bound at creation and are unaffected. |
|
|
|
Soft archive; hidden from list results by default, bound sessions remain available. |
|
|
|
Hard delete; configuration is removed and cannot be recovered. |