GuideLab API
Orders

Assign or unassign a work tray to a stage (lab only)

Sets orderPhase.workTrayId for one stage. A tray can occupy at most one active stage at a time; pass null workTrayId to unassign.

PATCH
/orders/{id}/phases/{phaseId}/work-tray

Sets orderPhase.workTrayId for one stage. A tray can occupy at most one active stage at a time; pass null workTrayId to unassign.

Authorization

__Secure-guidelab-prod.session_token<token>

Production session cookie set for the guidelab.co domain by Better Auth

In: cookie

Path Parameters

id*string
phaseId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PATCH "https://example.com/orders/string/phases/string/work-tray" \  -H "Content-Type: application/json" \  -d '{    "workTrayId": "string"  }'
{  "workTrayId": "string",  "workTray": {    "id": "string",    "code": "string",    "color": "string"  }}
Empty
Empty
{  "error": "string",  "conflict": {    "orderPhaseId": "string",    "phaseName": "string",    "orderId": "string",    "orderNumber": "string",    "sameOrder": true  }}

Approve surgical report (clinic only) POST

Approves the current immutable revision, completes the approval task, resolves its hold, and resumes production.

Bulk delete or cancel orders POST

Processes a batch of order IDs in a single request. Drafts are deleted while their clinical files are archived for durable retention cleanup; non-draft orders are cancelled. Each order is processed independently.