Ajax icon

Ajax

Consume Ajax API (v.0.1.2)

Actions242

Overview

This node, named "Ajax," is designed to interact with the Ajax API (version indicated in the code). It allows users to perform various operations on multiple resources managed by the Ajax system. Specifically, for the Group resource and the Get Group Info operation, the node retrieves detailed information about a particular group within a specified hub and user context.

Common scenarios where this node is beneficial include:

  • Fetching configuration or status details of a security group in an Ajax-managed environment.
  • Integrating Ajax group data into workflows for monitoring or reporting purposes.
  • Automating management tasks that require up-to-date group information.

For example, a user might use this node to get the current settings and member list of a security group before triggering alerts or updates elsewhere in their automation.

Properties

Name Meaning
User Id The identifier of the user who owns or manages the group.
Hub Id The identifier of the hub where the group is located.
Group Id The unique identifier of the group whose information is being requested.

All three properties are required string inputs and must be provided to successfully retrieve group information.

Output

The node outputs JSON data containing the detailed information of the specified group. This typically includes group metadata such as its name, members, settings, status, and other relevant attributes as defined by the Ajax API's response schema for group info.

If the node supports binary data output, it is not explicitly shown in the provided code snippet; thus, the primary output is structured JSON representing the group information.

Dependencies

  • Requires an API key credential for authenticating requests to the Ajax API.
  • Depends on the @digital-boss/n8n-designpatterns package for resource-operation resolution and execution logic.
  • Utilizes internal backend modules for state management, HTTP client communication, and operation methods.
  • The node expects proper configuration of the Ajax API credentials within n8n to function correctly.

Troubleshooting

  • Missing or invalid credentials: Ensure that the API key credential for the Ajax API is correctly configured and has sufficient permissions.
  • Incorrect property values: Verify that the User Id, Hub Id, and Group Id are accurate and correspond to existing entities in the Ajax system.
  • Network issues: Check connectivity to the Ajax API endpoint; network failures will prevent successful data retrieval.
  • API errors: If the API returns errors (e.g., unauthorized, not found), review the input parameters and credentials.
  • Version mismatch: Confirm that the node version aligns with the Ajax API version to avoid incompatibility issues.

Links and References

Discussion