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 a scheduled report. It is useful in scenarios where automated reports are no longer needed or must be removed due to changes in reporting requirements or cleanup tasks. For example, if a scheduled report was created but is now obsolete, this node can delete it by specifying its unique identifier.

Properties

Name Meaning
Id The unique identifier of the scheduled report to delete. Can be set using an expression.
If Match Optional ETag header value for concurrency control, ensuring the report is deleted only if it matches the specified version.

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 binary output associated with this operation.

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 HTTP requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Common issues:

    • Providing an incorrect or non-existent report Id will result in failure to delete.
    • Missing or invalid API authentication will cause authorization errors.
    • Using an outdated ETag value in the "If Match" property may lead to concurrency errors if the resource has changed since last retrieval.

  • Error messages:

    • 404 Not Found: The specified scheduled report Id does not exist.
    • 401 Unauthorized: Authentication failed; check API credentials.
    • 412 Precondition Failed: The ETag provided in "If Match" does not match the current version of the report.

To resolve these, verify the Id, ensure valid credentials, and update the ETag if using concurrency control.

Links and References

Discussion