Infomaniak CoreResources icon

Infomaniak CoreResources

Interact with Infomaniak API

Actions28

Overview

This node interacts with the Infomaniak API to manage various resources, including kSuite workspaces and mailboxes. Specifically, the Update Mailbox Password operation under the kSuite resource and workspace sub-resource allows users to update the password of a specified mailbox within their kSuite workspace.

This operation is useful in scenarios where mailbox credentials need to be changed for security reasons or when resetting access. For example, an administrator can automate password updates for multiple mailboxes without manually logging into each account.

Properties

Name Meaning
Sub Resource Selects the kSuite sub-resource category. Options: Workspace, My kSuite, Product Management
Mailbox ID The unique identifier of the mailbox whose password will be updated
New Password The new password string to set for the mailbox

Output

The output JSON contains a success confirmation message indicating that the mailbox password was updated successfully. The structure is:

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

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Infomaniak API.
  • The node makes HTTP requests to the Infomaniak API endpoints, specifically:
    • PUT https://api.infomaniak.com/2/profile/ksuites/mailboxes/{mailboxId}/update_password
  • Proper network connectivity to Infomaniak's API service is required.

Troubleshooting

  • Common issues:

    • Invalid or expired API token: The request will fail authentication.
    • Incorrect mailbox ID: The API may return an error if the mailbox does not exist or is inaccessible.
    • Insufficient permissions: The authenticated user must have rights to update the mailbox password.
    • Network errors or timeouts when connecting to the API.

  • Error messages:

    • "Failed to update mailbox password": Indicates the API call did not succeed; verify mailbox ID, API credentials, and permissions.
    • If the node throws an error about missing required parameters, ensure that both Mailbox ID and New Password are provided.

  • Resolution tips:

    • Double-check the mailbox ID is correct and accessible.
    • Verify the API key credential is valid and has necessary scopes.
    • Ensure the new password meets any complexity requirements enforced by Infomaniak.
    • Enable "Continue on Fail" in the node settings to handle errors gracefully during batch operations.

Links and References

  • Infomaniak API Documentation (general reference for API endpoints)
  • Infomaniak kSuite mailbox management API section (refer to official docs for detailed API specs)

Discussion