Update a pathway draft | CAIL Health

Updates an in-progress draft. Only the supplied fields change; everything else is preserved. Requires the client to send its current versionId in expectedVersionId for optimistic locking. A mismatch returns a conflict error and the client must refetch the draft before retrying. The decision tree is opaque JSON in this API; treat it as authored content the engine consumes.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Stable identifier of the draft pathway.

Request

This endpoint expects an object.

expectedVersionIddoubleRequired>=1

Client’s current versionId for optimistic locking. A mismatch with the server-side row returns a conflict error and the client must refetch.

titlestringOptional

Updated pathway title.

descriptionstringOptional

Updated pathway description.

decisionTreemap from strings to anyOptional

Updated decision-tree structure. Treat as opaque JSON; the shape is internal.

Response

The updated draft acknowledgement.

dataobject

messagestring

Human-readable acknowledgement.

$	curl -X PATCH https://staging.cail.health/v1/plan-definitions/a1b2c3d4-e5f6-4789-9abc-def012345678/draft \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"expectedVersionId": 7
>	}'

1	{
2	"data": {
3	"id": "a1b2c3d4-e5f6-4789-9abc-def012345678",
4	"versionId": 8,
5	"status": "draft",
6	"lastUpdated": "2026-05-13T14:21:00.000Z"
7	},
8	"message": "Draft updated successfully"
9	}