Immich icon

Immich

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

Overview

This node operation adds specified assets to an existing album in Immich, a self-hosted photo and video management solution. It is useful for organizing media by grouping multiple assets into a single album, facilitating easier management and retrieval. For example, a user can add a batch of photo IDs to a vacation album to keep all related photos together.

Use Case Examples

  1. Add multiple photo IDs to a specific album by providing the album ID and a comma-separated list of asset IDs.
  2. Use batching options to add assets in controlled batches to avoid overwhelming the server.

Properties

Name Meaning
Album ID The unique identifier of the album to which assets will be added.
Asset IDs Comma-separated list of asset IDs to add to the album. These IDs are split and trimmed before sending in the request body as an array under the 'ids' property.
Request Options Additional request settings including batching (to split input into batches and throttle requests), ignoring SSL issues, proxy configuration, and request timeout settings.

Output

JSON

  • success - Indicates whether the assets were successfully added to the album.
  • albumId - The ID of the album to which assets were added.
  • addedAssetIds - List of asset IDs that were added to the album.

Dependencies

  • Requires an API key credential for Immich API authentication.

Troubleshooting

  • Ensure the Album ID and Asset IDs are valid and exist in the Immich system to avoid errors.
  • If batching is enabled, verify batch size and interval settings to prevent request throttling issues.
  • Check proxy and SSL settings if requests fail due to network or certificate issues.
  • Timeout errors may occur if the server is slow; increase the timeout setting if needed.

Discussion