Read laboratory workbenches
GET /api/v1/laboratory/workbenches/{workbenchId}: request fields and declared response contract.
GET/api/v1/laboratory/workbenches/{workbenchId}
| Property | Value |
|---|---|
| Permission | laboratory.method.read |
| Workspace scope | required |
| Scope target | workspace |
Parameters
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| workbenchId | string | required | non-null | — |
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| revision | integer | optional | non-null | — |
Response
200
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| data | object | required | non-null | — |
| data.document | object | required | non-null | — |
| data.document.workbenchId | string | required | non-null | — |
| data.document.title | string | required | non-null | — |
| data.document.objective | string | required | non-null | "" |
| data.document.graph | object | required | non-null | — |
| data.document.graph.schemaVersion | number | required | non-null | — |
| data.document.graph.nodes | array | required | non-null | — |
| data.document.graph.edges | array | required | non-null | — |
| data.acceptance | object | required | non-null | — |
| data.acceptance.policyDigest | string | required | non-null | — |
| data.acceptance.capabilityDigest | string | required | non-null | — |
| data.acceptance.readiness | object | required | non-null | — |
| data.acceptance.readiness.authorable | boolean | required | non-null | — |
| data.acceptance.readiness.executable | boolean | required | non-null | — |
| data.acceptance.readiness.reasons | array | required | non-null | — |
| data.acceptance.resolvedReferences | array | required | non-null | — |
| data.revision | integer | required | non-null | — |
| data.parentRevision | integer | required | nullable | — |
| data.digest | string | required | non-null | — |
| data.sealDigest | string | required | non-null | — |
| data.createdAt | string | required | non-null | — |
| data.createdBy | string | required | non-null | — |
Declared failures
| Property | Value |
|---|---|
| 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.workbenches.read
Request example
Schematic only. Replace placeholders with real values and include all required nested fields.
GET /api/v1/laboratory/workbenches/{workbenchId} HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>