Harbor Gateway
  1. Controllers
Harbor Gateway
  • Harbor Gateway API
    • Health & Status
      • Admin interface
      • Health check
    • Transactions
      • List all transactions
      • Create a transaction
      • Get transaction details
      • Release transaction
      • Open locker by transaction ID
    • Lockers
      • List all lockers
      • Get locker details
      • Open locker by ID
      • Open all lockers
    • System
      • Get system information
      • Update system configuration
      • Get system logs
    • Schemas
      • Locker
      • TransactionResponse
      • LockController
      • System
      • LogEntry
      • OperationResponse
      • LockerOperationResponse
      • MultiStatusOperationResponse
      • OpenAllLockersResponse
      • Error
  • Harbor Gateway Admin API
    • Authentication
      • Login with Basic Auth and receive session token
      • Logout and invalidate session token
    • Controllers
      • List all lock controllers
        GET
      • Manually add a lock controller
        POST
      • Trigger manual mDNS scan
        POST
      • Get controller details
        GET
      • Update controller settings
        PATCH
      • Remove controller from system
        DELETE
      • Replace a failed controller
        POST
      • Adjust locker count for controller
        PATCH
    • Lockers
      • Update locker service state
    • System
      • Refresh network information
      • Reboot gateway system
    • Diagnostics
      • Test Sentry error tracking integration
    • Schemas
      • Schemas
        • Controller
        • ControllerDetails
        • CreateControllerRequest
        • AdjustLockerCountResponse
        • OperationResponse
        • Error
      • Response
        • Unauthorized
        • NotFound
        • InternalServerError
  1. Controllers

Remove controller from system

DELETE
/controllers/{controllerId}
Delete a lock controller and all its lockers from the system.
Controller must not have any active transactions on its lockers.
Caution: This operation deletes the controller and all its lockers.
Historical logs will have lock_controller_id set to NULL but remain in the system.
This operation cannot be undone.

Request

Authorization
Basic Auth
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
or
API Key
Add parameter in header
X-Session-Token
Example:
X-Session-Token: ********************
or
Path Params

Responses

🟢200OK
application/json
Controller and all its lockers deleted successfully
Body

🟠404Not Found
🟠409Conflict
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE '/controllers/' \
--header 'Authorization: Basic <encoded-value>'
Response Response Example
200 - Example 1
{
    "success": true,
    "lockersDeleted": 0
}
Modified at 2025-11-27 00:06:25
Previous
Update controller settings
Next
Replace a failed controller
Built with