Update locker service state

Update a locker's service state (enable/disable for maintenance, mark broken lock).

Mark out of service:
Disable a locker for maintenance or due to hardware issues. Locker becomes
unavailable for new transactions. Existing transactions are preserved but
may not be openable if hardware has failed.

Set outOfService: true with reasonCode and reason fields.

Return to service:
Re-enable a locker that was previously marked out of service. Locker becomes
available for new transactions if operational and not assigned.

Set outOfService: false. The reasonCode and reason fields are optional
and will be cleared if not provided.

Mark broken lock (GPIO expander bug workaround):
Mark a locker as having a broken lock sensor due to known GPIO expander hardware bug.
When brokenLock: true, the lock will still fire but door sensor failures are ignored
(treated as success). This allows lockers with unreliable sensor feedback to remain operational.

Set brokenLock: true to enable workaround, brokenLock: false to disable.

Note: Lockers with certain types (e.g., screen lockers marked always_oos: true)
cannot be returned to service via this endpoint (returns 409 CONFLICT).

curl --location --request PATCH '/lockers/' \ --header 'Content-Type: application/json' \ --data-raw '{ "outOfService": true, "reasonCode": "LOCK_MALFUNCTION", "reason": "Lock solenoid not responding" }'

Update locker service state

Request

Responses