Env Registry
Env Registry API endpoints
Env Registry API endpoints
Every request needs a credential — see Authentication.
| Method | Path | Summary |
|---|
GET | /sandbox/env/v1/bases | List Bases |
POST | /sandbox/env/v1/bases | Publish Base |
GET | /sandbox/env/v1/envs | List Envs |
GET | /sandbox/env/v1/envs/{fingerprint} | Get Env |
POST | /sandbox/env/v1/envs/resolve | Resolve |
Accepted on every endpoint on this page.
| Name | In | Type | Required | Description |
|---|
x-correlation-id | header | string | no | End-to-end correlation id for this eval run. When set, the gateway and downstream services honor it verbatim in logs, Cloud Trace span attributes, async job payloads, and Langfuse trace.id. When omitted, the gateway generates a ULID and echoes it on the response. |
GET /sandbox/env/v1/bases
| Status | Description | Body |
|---|
200 | Successful Response | BasesResponse |
POST /sandbox/env/v1/bases
application/json, required — PublishBaseRequest
| Field | Type | Required | Description |
|---|
id | string | yes | |
image | string | yes | |
| Status | Description | Body |
|---|
200 | Successful Response | BaseResponse |
422 | Validation Error | HTTPValidationError |
GET /sandbox/env/v1/envs
| Name | In | Type | Required | Description |
|---|
base | query | string | null | no | |
| Status | Description | Body |
|---|
200 | Successful Response | EnvsResponse |
422 | Validation Error | HTTPValidationError |
GET /sandbox/env/v1/envs/{fingerprint}
| Name | In | Type | Required | Description |
|---|
fingerprint | path | string | yes | |
| Status | Description | Body |
|---|
200 | Successful Response | EnvResponse |
422 | Validation Error | HTTPValidationError |
POST /sandbox/env/v1/envs/resolve
application/json, required — ResolveRequest
| Field | Type | Required | Description |
|---|
base | string | yes | |
dependencies | string[] | no | |
| Status | Description | Body |
|---|
200 | Successful Response | EnvResponse |
422 | Validation Error | HTTPValidationError |
The object shapes referenced above.
| Field | Type | Required | Description |
|---|
id | string | yes | |
digest | string | yes | |
image | string | yes | |
| Field | Type | Required | Description |
|---|
bases | BaseResponse[] | yes | |
| Field | Type | Required | Description |
|---|
status | string | yes | |
fingerprint | string | yes | |
image | string | null | yes | |
base | string | yes | |
dependencies | string[] | yes | |
error | string | null | no | |
| Field | Type | Required | Description |
|---|
envs | EnvResponse[] | yes | |
| Field | Type | Required | Description |
|---|
detail | ValidationError[] | no | |
| Field | Type | Required | Description |
|---|
id | string | yes | |
image | string | yes | |
| Field | Type | Required | Description |
|---|
base | string | yes | |
dependencies | string[] | no | |
| Field | Type | Required | Description |
|---|
loc | string | integer[] | yes | |
msg | string | yes | |
type | string | yes | |
input | any | no | |
ctx | object | no | |
Machine-readable spec: OpenAPI YAML.