Infomaniak CoreResources icon

Infomaniak CoreResources

Interact with Infomaniak API

Overview

This node interacts with the Infomaniak API to retrieve multiple asynchronous tasks ("Task" resource, "Get Many" operation). It allows users to fetch a list of tasks with flexible pagination, filtering, and sorting options. This is useful for monitoring or managing background jobs or asynchronous operations within the Infomaniak platform.

Typical use cases include:

  • Retrieving all or a subset of asynchronous tasks to check their status.
  • Paginating through large sets of tasks.
  • Sorting tasks by specific fields to prioritize or analyze them.
  • Skipping a number of tasks to implement custom paging logic.

For example, you might use this node to get all running or completed tasks related to your account, or to fetch a limited number of recent tasks ordered by creation date.

Properties

Name Meaning
Return All Whether to return all available tasks or limit the number of results.
Limit Maximum number of tasks to return (used if Return All is false).
Additional Options Collection of optional parameters:
- Return What to return; currently supports "Total" to return total count instead of task items.
- Skip Number of tasks to skip (offset) before starting to return results.
- Page Page number for pagination.
- Per Page Number of tasks per page (page size).
- Order By Field name to order the results by.
- Order Order direction: Ascending or Descending.
- Order For Order direction for fields (can specify different directions for different fields).

Output

The node outputs an array of JSON objects representing tasks retrieved from the Infomaniak API. Each object corresponds to one asynchronous task and contains all relevant task details as provided by the API.

If the "Return" option in Additional Options is set to "Total", the output will contain the total count of tasks instead of task items.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Infomaniak API.
  • The node makes HTTP GET requests to the endpoint https://api.infomaniak.com/1/async/tasks.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Failed to retrieve tasks: This error occurs if the API request fails or returns an unexpected result. Check that the API key is valid and has sufficient permissions.
  • Invalid parameter values: Ensure numeric parameters like Limit, Skip, Page, and Per Page are positive integers.
  • Pagination issues: If using both Skip and Page/Per Page, verify that the combination makes sense to avoid missing or duplicate tasks.
  • Order By field invalid: If ordering by a field not supported by the API, the request may fail or return unordered results.
  • API rate limits: Excessive requests may be throttled by the API; consider adding delays or reducing frequency.

Links and References


This summary is based on static analysis of the node's source code and input property definitions for the Task resource's Get Many operation.

Discussion