Replace a failed controller
POST
/controllers/{controllerId}/replace
locker bank remains the same, so the old controller's locker records are
reassigned to the new controller, preserving all active transactions and locker IDs.
New controllers are automatically provisioned with 20 lockers during mDNS discovery.
During replacement, these auto-created lockers are deleted and the old controller's
existing locker records are reassigned to maintain consistency.
1.
2.
3.
4.
5.
6.
7.
Request
Path Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/controllers//replace' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
"newControllerId": 0
}'Response Response Example
200 - Example 1
{
"success": true,
"reassignedLockers": 0,
"activeTransactions": 0
}Modified at 2025-11-27 00:06:25