Infomaniak CoreResources icon

Infomaniak CoreResources

Interact with Infomaniak API

Overview

The node interacts with the Infomaniak API to manage various resources, including kSuite workspaces and mailboxes. Specifically, for the kSuite resource and the Unlink Mailbox operation, it allows users to unlink (detach) a mailbox from the current user’s kSuite workspace.

This operation is useful when you want to remove access or association of a particular mailbox from your kSuite account without deleting the mailbox itself. For example, if a user no longer needs to use a specific mailbox or wants to switch to another mailbox, this operation can be used to unlink the old mailbox cleanly.

Practical Example

  • A company admin wants to unlink an employee's mailbox from their kSuite workspace after the employee leaves.
  • A user wants to detach a mailbox they previously attached to their kSuite profile.

Properties

Name Meaning
Sub Resource The subcategory within kSuite; options are: Workspace, My kSuite, Product Management.
Mailbox ID The unique identifier of the mailbox to unlink. This is required for the unlinkMailbox operation under the Workspace sub-resource.

Output

The output JSON contains a success confirmation message indicating whether the mailbox was successfully unlinked. The structure is:

{
  "success": true,
  "message": "Mailbox <mailboxId> unlinked successfully"
}

No binary data is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Infomaniak API.
  • The node makes HTTP DELETE requests to the Infomaniak API endpoint for unlinking mailboxes.
  • No additional external dependencies beyond the Infomaniak API and n8n's HTTP request helper.

Troubleshooting

  • Common Issues:

    • Invalid or missing Mailbox ID will cause the operation to fail.
    • Authentication errors if the API token is invalid or expired.
    • Network issues preventing connection to the Infomaniak API.
  • Error Messages:

    • "Failed to unlink mailbox": General failure to unlink, possibly due to invalid mailbox ID or permission issues.
    • If the mailbox ID does not exist or is not linked to the user, the API may return an error that results in this message.
  • Resolution Tips:

    • Verify the Mailbox ID is correct and currently linked.
    • Ensure the API key credential has sufficient permissions.
    • Check network connectivity and API availability.
    • Enable "Continue on Fail" in the node settings to handle errors gracefully during batch operations.

Links and References


This summary focuses exclusively on the kSuite resource and the unlinkMailbox operation as requested.

Discussion