Complete a task
Sets status=done, stamps completedAt/completedById and appends a timeline activity when the task has a patient. Idempotent. 409 when the lead is locked by another user on the Today page (LOCKED), or for a compliance check's task, which closes only by recording the check (COMPLIANCE_TASK_NEEDS_ENTRY); 503 when that lock could not be checked (LOCK_CHECK_UNAVAILABLE, nothing saved) or the save was interrupted (SAVE_INTERRUPTED) — retry the request.
Loading the API reference…
Cancel an open task with a reason POST
Moves an open task to cancelled and keeps the reason in its history (`task_cancelled`). 409 TASK_NOT_OPEN when it is not open; 409 COMPLIANCE_TASK_NEEDS_ENTRY for a compliance check's task, which closes by recording the check (or disabling it); 409 TASK_KIND_RESERVED for an outcome record; 409 VERSION_CONFLICT on a stale expectedVersion. The same scope as PATCH applies (404 outside it).
The consultation a consultation check asks about GET
For an open `consultation_check` task: the diary visit its booking stands for (the visit pinned on the check, else the one the booking named, else the patient's single visit that day) and how it can be moved — `check` (no visit), `diary` (Smileline's own diary), `pms` (the connected PMS moves it: Dentally, Open Dental) or `pms_check` (the PMS cannot be written to; the question moves and the sync brings the visit). `messages` names, per answer, the channels of the appointment messages switched on for this visit (settings, not a delivery promise; null when unknown). `pms.operation` is the latest provider move while the visit is not yet where it was asked to go. Reads only. 404 when the caller cannot read the task; 409 NOT_A_CONSULTATION_CHECK, TASK_NOT_OPEN, CONSULTATION_CHECK_SUPERSEDED, or PMS_OPERATION_PENDING while the PMS is still creating the visit.