Infomaniak CoreResources icon

Infomaniak CoreResources

Interact with Infomaniak API

Actions28

Overview

This node interacts with the Infomaniak API to retrieve detailed information about events. Specifically, the "Event" resource with the "Get" operation allows users to fetch data for a single event by its unique identifier. This is useful in scenarios where you want to obtain specific details about an event, such as its status, type, or description, for further processing or integration within an automation workflow.

Practical examples include:

  • Fetching details of a scheduled maintenance event to notify stakeholders.
  • Retrieving information about a security-related event (e.g., cyber attack) for logging or alerting.
  • Accessing event metadata to update dashboards or trigger conditional logic based on event status.

Properties

Name Meaning
Event ID The unique identifier of the event to retrieve. It must be a number and is required.

Output

The output is a JSON object representing the detailed data of the requested event. The structure corresponds to the event data returned by the Infomaniak API's /2/events/{eventId} endpoint. It typically includes fields such as event ID, type, status, timestamps, descriptions, locale, and flags like whether it is a cyber attack or automatic event.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential for the Infomaniak API.
  • The node makes HTTP GET requests to the Infomaniak API endpoint: https://api.infomaniak.com/2/events/{eventId}.
  • Proper configuration of the API key credential in n8n is necessary for successful authentication.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Event ID will result in an error indicating the event was not found.
    • Network connectivity problems or incorrect API credentials will cause request failures.
    • If the API rate limits are exceeded, requests may fail temporarily.

  • Error messages:

    • "Event with ID {eventId} not found": Indicates that no event exists with the specified ID. Verify the Event ID is correct.
    • "Failed to retrieve event": A general failure to fetch event data, possibly due to network issues or invalid credentials.

  • Resolutions:

    • Double-check the Event ID input.
    • Ensure the API key credential is valid and has sufficient permissions.
    • Check network connectivity and retry after some time if rate-limited.

Links and References

Discussion