3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node interacts with the 3CX telephony system, specifically allowing users to delete firmware entries from the system. The "Delete Firmware" operation removes a firmware entity identified by its unique ID. This is useful for managing and cleaning up firmware versions that are no longer needed or supported in your 3CX environment.

Practical examples include:

  • Automating the removal of outdated or deprecated firmware versions.
  • Integrating firmware management into broader telephony system maintenance workflows.

Properties

Name Meaning
Id The unique identifier of the firmware entity to delete. Can be set using an expression like {{$json.Id}}.
If Match Optional ETag header value used for concurrency control to ensure the firmware has not changed since last retrieval.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will confirm whether the deletion was successful or provide error details if it failed. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • The base URL for the 3CX API must be configured in the credentials.
  • The node sends requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Common issues:

    • Providing an incorrect or missing firmware ID will cause the delete operation to fail.
    • Using an invalid or stale ETag value in the "If Match" property may result in a concurrency error.
    • Network or authentication errors if the API key or server URL is misconfigured.

  • Error messages:

    • "Firmware not found" indicates the specified ID does not exist.
    • "Precondition Failed" or similar errors indicate ETag mismatch; refresh the firmware data before retrying.
    • Authentication errors suggest checking the API key credential and server URL configuration.

Links and References

Discussion