Update location in zone

Updates a location in a zone: its name, floor, room and bed, the devices assigned to it, and the resident on those devices.

Auth: Bearer token. The caller must be a practitioner, an admin, a super admin, or hold the "System Owner" access policy. The access policy must grant Location:update and Device:update (an admin or super admin who holds no access policy skips this check). Scope: The zone must belong to the caller's project (from the token), its parent project, or one of its sub-projects. The location must be in the caller's project, and its managing organization must be the zone. Devices and residents named in the body must be in your project or a sub-project.

Behaviour

• name is required and must be unique among the locations your token can search, not counting this one.
• floor, room and bed replace only the values you send; omitted ones keep their stored value. The resulting floor, room and bed must not match another location in the zone.
• deviceId (one UUID or a list) sets the devices at the location to exactly that set: devices not listed are removed from it, new ones are added. null removes every device. Omit deviceId to leave the devices unchanged.
• patientId assigns that resident to the devices named in deviceId, or, without deviceId, to the location's single device. A resident assigned there before is unassigned from those devices.
• Omitting patientId unassigns the current resident from every device at the location (and from the devices in deviceId). Send the current patientId to keep the resident.
• A discharged resident cannot be assigned.
• The write is atomic and takes a short write lock on the devices and locations it touches.
• The response is the updated location, in the same shape as GET /v1/slim/location/{id}.

Example

curl -X PUT 'https://api.sandbox.ovok.com/v1/slim/zones/c3499c27-2973-0a7f-807e-fb8676a92dcb/locations/87ea5dfc-8b8e-384d-8489-79496e706390' \  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk' \  -H 'Content-Type: application/json' \  -d '{    "name": "Room 101 Bed 1",    "room": "101",    "bed": "1",    "deviceId": "c3499c27-2973-0a7f-807e-fb8676a92dcb",    "patientId": "87ea5dfc-8b8e-384d-8489-79496e706390"  }'