Update location

Updates a location: its name, floor, room, bed and zone, the devices at 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 location must belong to the caller's project (from the token). Devices and residents you attach must be in your project or one of its sub-projects. The zone must be in your project, a sub-project, or the parent project.

Behaviour

• name is required and must be unique among the locations your token can search, not counting this one.
• floor, room, bed: an omitted field keeps its current value. If the zone, floor, room or bed changes, the new combination must not match another location's.
• organizationId:
  • omitted: the zone is unchanged.
  • null: the zone is removed from the location and from every device at it.
  • an id: the location and every device at it move to that zone. Residents on those devices move too.
• deviceId (one id or a list):
  • omitted: the devices at the location are unchanged.
  • a list: it becomes the full set of devices at the location. Devices not in the list are detached; new ones are attached. null or [] detaches all devices.
  • Devices that hold a discharged resident cannot be attached.
• patientId:
  • an id: that resident is assigned to the devices in deviceId, or, when deviceId is omitted or empty, to the single device at the location. The resident is first removed from any other device. A resident already on a target device is replaced. A discharged resident is refused.
  • omitted: every resident is removed from every device at the location and every device in deviceId. To keep the current resident, send their patientId.
• A resident who loses a device has their active out-of-bed notification revoked in the same write, and the device's live telemetry state is cleared afterwards.
• Device use history is updated for every device whose resident changes.
• The write is atomic and takes a short write lock. A concurrent write to the same resources, or a device reassigned by someone else while this request ran, gets a 409.
• Every save adds a location-updated entry to the change history. Residents who move into a new zone, or lose a device, also get an entry in their own change history.
• The response is the location after the update, in the same shape as GET /v1/slim/location/{id}.
• If another location has the same zone, floor, room and bed, the request is refused with 409 and the body carries existingLocationId and existingLocationName.

Example

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