Get sandboxes
GET /api/v1/laboratory/sandboxes/{sandboxRef}: request fields and declared response contract.
GET/api/v1/laboratory/sandboxes/{sandboxRef}
| Permission | laboratory.sandbox.read |
|---|---|
| Workspace scope | required |
| Scope target | resource |
Parameters
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| sandboxRef | string | required | non-null | — |
Query parameters: none.
Response
200
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| data | object | required | non-null | — |
| data.sandboxRef | string | required | non-null | — |
| data.name | string | required | non-null | — |
| data.purpose | string | required | non-null | — |
| data.state | "active" | "archived" | required | non-null | — |
| data.retentionClass | "ephemeral" | "standard" | "decision_evidence" | "legal_hold" | required | non-null | — |
| data.heldForEvidence | boolean | required | non-null | — |
| data.headRevisionRef | string | required | non-null | — |
| data.defaultBranch | string | required | non-null | — |
| data.createdAt | string | required | non-null | — |
| data.updatedAt | string | required | non-null | — |
Declared failures
| ACCESS_DENIED | 403 — not retryable |
|---|---|
| CORE_ERROR | 500 — not retryable |
| GOVERNANCE_DENIED | 403 — not retryable |
| NOT_FOUND | 404 — not retryable |
| SETUP_REQUIRED | 503 — not retryable |
| VALIDATION_ERROR | 400 — not retryable |
| VALIDATION_INPUT_ERROR | 400 — not retryable |
Readback
This method returns the current state it read.
- laboratory.sandboxes.read
Request example
Schematic only. Replace placeholders with real values and include all required nested fields.
GET /api/v1/laboratory/sandboxes/{sandboxRef} HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>