Actions77
- Accessory Actions
- Authentication Actions
- Backup & Restore Actions
- Config Editor Actions
- Platform Tool Actions
- Plugin Actions
- Server Actions
- Restart Server
- Restart Child Bridge
- Stop Child Bridge
- Start Child Bridge
- Get Pairing Info
- Reset Homebridge Accessory
- Reset Cached Accessories
- Get Cached Accessories
- Delete Cached Accessories
- Delete Cached Accessory
- Get Device Pairings
- Get Device Pairing
- Delete Device Pairing
- Get Unused Port
- Get Network Interfaces
- Get Bridge Network Interfaces
- Set Bridge Network Interfaces
- Setup Wizard Actions
- Status Actions
- User Actions
Overview
This node interacts with the Homebridge API, specifically allowing control over various Homebridge resources. The "Delete Device Pairing" operation under the "Server" resource enables users to remove the pairing information of a child device (child bridge) connected to the Homebridge server. This is useful when you want to unpair or reset a device's connection to the Homebridge server, for example, if a device is being replaced or needs to be reconfigured.
Practical scenarios include:
- Removing an old or malfunctioning child bridge from the Homebridge server.
- Resetting pairing info to troubleshoot connectivity issues between Homebridge and a child device.
- Managing devices programmatically as part of automated maintenance workflows.
Properties
| Name | Meaning |
|---|---|
| Access Token | An access token obtained from a prior login operation. If not using a Login node, enter manually. Used for authenticating API requests. |
| Device ID | The unique identifier of the child bridge device whose pairing information you want to delete. This is required. |
| Reset Pairing Info | A boolean flag indicating whether to reset the pairing information on the device. true means reset pairing info; false means do not reset. |
Output
The node outputs JSON data representing the response from the Homebridge API after attempting to delete the device pairing. This typically includes status information about the success or failure of the operation. The exact structure depends on the API response but generally confirms whether the device pairing was successfully deleted or reset.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Homebridge API server.
- Needs an API authentication token (access token) which can be obtained via a login operation or entered manually.
- The base URL of the Homebridge server must be configured in the node credentials.
- The node depends on the Homebridge API being accessible and properly configured to accept requests.
Troubleshooting
- Invalid or missing Access Token: If the access token is incorrect or expired, the API will reject the request. Ensure the token is valid and refreshed if necessary.
- Incorrect Device ID: Providing a wrong or non-existent device ID will cause the operation to fail. Verify the device ID corresponds to a registered child bridge.
- Network or Server Issues: Connectivity problems or server downtime will prevent successful API calls. Check network connections and server status.
- Permission Denied Errors: Insufficient permissions associated with the access token may block deletion. Confirm that the token has appropriate rights.
- Reset Pairing Info Misuse: Setting the reset flag incorrectly might lead to unintended device resets. Use this option carefully.
Links and References
- Homebridge API Documentation (for detailed API endpoints and usage)
- Homebridge Official Website
- n8n Documentation on Creating Custom Nodes