3CX icon

3CX

Interact with 3CX telephony system

Actions462

Overview

This node interacts with the 3CX telephony system, specifically providing an operation to revoke a token associated with "My Tokens". It is useful in scenarios where you need to invalidate or remove access tokens for security reasons or to manage active sessions. For example, if a token has been compromised or is no longer needed, this node can be used to revoke it programmatically.

Properties

Name Meaning
Id The unique identifier of the token entity to revoke. This is a required numeric value and can be dynamically set using expressions like {{$json.Id}}.

Output

The node outputs JSON data representing the result of the revoke token operation. Typically, this would include confirmation of the token revocation status or any relevant metadata returned by the 3CX API. 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 node expects a base URL for the 3CX server, which should be configured in the credentials.
  • The node sends requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Common issues:
    • Invalid or missing token ID: Ensure the Id property is correctly provided and corresponds to an existing token.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Incorrect server URL: Confirm the 3CX server URL is correctly set without trailing slashes.
  • Error messages:
    • Authorization failures typically indicate invalid credentials or insufficient permissions.
    • Not found errors suggest the token ID does not exist or has already been revoked.
  • To resolve these, double-check input values, credentials, and server configuration.

Links and References

Discussion