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 partial-update semantics; fields you pass are updated and omitted fields retain their existing values (
config.typeis immutable;config.packagesandmetadataare replaced wholesale when provided). 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. | |
| Partial update; omitted fields retain their existing values. 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. |