GuideLab Docs
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"  },  "taskAdvanced": true,  "taskBlockedReason": "no_tray_task"}
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 with the clinic doctor's signed authorization to proceed, completes the approval task, resolves its hold, resumes production, and attaches the signed authorization PDF to the order.

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.