Immich icon

Immich

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

Overview

This node allows users to create a new album in Immich, a self-hosted photo and video management solution. It is useful for organizing assets such as photos and videos into albums. Users can specify the album name, add a description, and optionally include a list of asset IDs to be added to the album initially. This node supports batching of requests, proxy configuration, SSL certificate validation options, and request timeout settings.

Use Case Examples

  1. Creating a new photo album named 'Vacation 2024' with a description and adding specific photos by their asset IDs.
  2. Organizing a collection of videos into a new album while handling large input by batching requests to avoid server overload.

Properties

Name Meaning
Album Name The name of the album to create, required for album creation.
Additional Fields Optional fields to provide extra information about the album, including description and initial asset IDs to add.
Request Options Settings to control request behavior such as batching, SSL certificate validation, proxy usage, and timeout duration.

Output

JSON

  • albumId - The unique identifier of the created album.
  • albumName - The name of the created album.
  • description - The description of the created album, if provided.
  • assetIds - List of asset IDs initially added to the album.
  • createdAt - Timestamp when the album was created.

Dependencies

  • Requires an API key credential for Immich API authentication.

Troubleshooting

  • Common issues include invalid or missing album name, which will cause the creation to fail.
  • Incorrectly formatted asset IDs (not comma-separated or containing invalid IDs) may cause errors or unexpected behavior.
  • Network issues such as proxy misconfiguration or SSL certificate problems can cause request failures; enabling 'Ignore SSL Issues' or correctly setting proxy may resolve these.
  • Timeouts can occur if the server is slow to respond; increasing the timeout setting may help.

Links

  • Immich API Documentation - Official API documentation for Immich, useful for understanding available endpoints and request formats.

Discussion