The patient's picture
The 96 px WebP cut from the photo the picture names (`picture.version` on the patient's detail, `pictureVersion` on a diary item: pass it as `v`). Made from the photo the first time it is asked for, its read audited as a clinical read (purpose `picture`). `Cache-Control: private, no-cache` with the version as ETag: a browser keeps it and asks again, answered 304 while it is current. Requires patient:read. 404 when the patient has no picture (or its photo was entered in error or deleted); 503 PICTURE_NOT_READY, not stored, while the photo's copy is not yet verified.
Loading the API reference…
Remove the patient's picture DELETE
The photo itself stays. Idempotent. Requires patientDocument:file.
Use one of the patient's photos as their picture PUT
Replaces any picture (a new version). Cropped round the face the photo's image check found, else round its subject. Requires patientDocument:file. 422 PICTURE_PHOTO_INVALID when the document is not this patient's live photo of a readable type within 20 MB.