Delete device

Method	Path
DELETE	/v1/slim/device/:id

Authentication · Access policies

Deletes a device from your project.

Auth: bearer token. The caller must be a practitioner, an admin or a System Owner, and needs Device:delete. System Owners cannot delete devices. Scope: the device must belong to the caller's project (from the token).

Behaviour

• The Device resource is deleted. This cannot be undone.
• If a resident is assigned, they are unassigned and their active out-of-bed episode is closed in the same transaction.
• The device's use history is updated in the same transaction.
• The delete is recorded in the change history.
• The response has no body.

Example

curl -X DELETE 'https://api.sandbox.ovok.com/v1/slim/device/3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21' \
  -H "Authorization: Bearer ${OVOK_TOKEN}"

Successful response

200 — Device deleted. The response has no body.

Errors

Status	Meaning
401	Bearer token is missing, invalid or expired.
403	You are not a practitioner, admin or System Owner, you lack Device:delete, you have the System Owner policy, or the device does not exist or is not in your project.
422	id is not a UUID.