Immich icon

Immich

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

Overview

This node interacts with the Immich API to retrieve information about a specific asset (photo or video) by its ID. It is useful in scenarios where you need to fetch detailed metadata or information about a particular asset stored in the Immich self-hosted photo and video management system. For example, you might use this node to get asset details for display in a custom gallery or to process asset metadata in an automation workflow.

Use Case Examples

  1. Retrieve asset details by providing the Asset ID to display metadata in a dashboard.
  2. Fetch asset information to use in a conditional workflow step based on asset properties.

Properties

Name Meaning
Asset ID The ID of the asset to retrieve, update, or delete. This is required to specify which asset to get.
Request Options Additional options to customize the request behavior, including batching, SSL certificate validation, proxy settings, and timeout duration.

Output

JSON

  • id - The unique identifier of the retrieved asset.
  • filename - The filename of the asset.
  • url - The URL to access the asset.
  • metadata - Metadata information related to the asset, such as creation date, size, and type.

Dependencies

  • Requires an API key credential for Immich API authentication.

Troubleshooting

  • Common issues include providing an invalid or missing Asset ID, which will result in errors or no data returned.
  • SSL certificate validation errors can occur if the server uses a self-signed or invalid certificate; enabling 'Ignore SSL Issues' can bypass this but reduces security.
  • Timeout errors may happen if the server is slow or unresponsive; increasing the timeout setting can help.
  • Proxy misconfiguration can prevent the node from connecting to the API; ensure proxy settings are correct.

Discussion