Acknowledge a completed pathway execution | CAIL Health

Optional telemetry acknowledgement that the client has displayed the terminal. The engine has already transitioned the execution to completed on the prior submitAnswer response that returned a terminal node; this endpoint exists for symmetry with the legacy navigation-session lifecycle and to record an optional selectedProviderId for analytics. Returns the lifecycle envelope reflecting the completed state.

Optional telemetry acknowledgement that the client has displayed the terminal. The engine has already transitioned the execution to `completed` on the prior `submitAnswer` response that returned a terminal node; this endpoint exists for symmetry with the legacy navigation-session lifecycle and to record an optional `selectedProviderId` for analytics. Returns the lifecycle envelope reflecting the completed state.

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

Stable identifier of the pathway execution.

Request

This endpoint expects an object.

selectedProviderIdstringOptional

Stable identifier of a provider the member selected from the follow-up routing results. Analytics-only.

Response

The envelope after completion.

envelopeobject

Lifecycle envelope reflecting the updated execution.

$	curl -X POST https://staging.cail.health/v1/pathway-executions/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f/complete \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"envelope": {
3	"id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
4	"planDefinitionId": "a1b2c3d4-e5f6-4789-9abc-def012345678",
5	"planDefinitionVersionId": 42,
6	"channel": "mobile",
7	"status": "completed",
8	"startedAt": "2026-05-13T14:21:00.000Z",
9	"endedAt": "2026-05-13T14:23:11.000Z",
10	"outcomeCode": "pharmacy"
11	}
12	}