Immich icon

Immich

Interact with Immich, a self-hosted photo and video management solution

Overview

This node interacts with the Immich API to retrieve multiple albums. It is useful for scenarios where users want to fetch a list of albums, including optionally those shared with them, from their self-hosted Immich photo and video management system. For example, it can be used to display all albums in a gallery application or to synchronize album data with another service.

Use Case Examples

  1. Fetch all albums owned by the user.
  2. Fetch all albums including those shared with the user by enabling the 'Include Shared' option.

Properties

Name Meaning
Include Shared Whether to include albums shared with the user in the results.
Items per Batch Number of albums to fetch per batch request to throttle API calls.
Batch Interval (ms) Time interval in milliseconds between each batch of requests.
Ignore SSL Issues (Insecure) Whether to accept responses even if SSL certificate validation fails.
Proxy HTTP proxy URL to route requests through, including optional authentication.
Timeout Maximum time in milliseconds to wait for the server response before aborting the request.

Output

JSON

  • albums - Array of album objects retrieved from the Immich API, including album metadata such as ID, title, description, and shared status.

Dependencies

  • Immich API
  • An API key credential for authentication

Troubleshooting

  • If the node fails to retrieve albums, check the API base URL and credentials for correctness.
  • Timeout errors may occur if the server is slow or unreachable; increase the timeout setting if needed.
  • If SSL certificate errors occur, enable the 'Ignore SSL Issues' option to bypass validation, but be aware of security risks.
  • Proxy settings must be correctly configured if a proxy is required to access the API.

Links

Discussion