update_assets_metadata
Batch-update metadata for multiple photos at once: set date, GPS location, description, favorite status, or rating across selected assets in a single call.
Instructions
Update the same metadata fields on many assets in ONE call — the whole roll of a scanned album gets its real date, a trip's photos get their GPS, a selection becomes favorites. Same fields as update_asset_metadata; only the provided ones change. Side effect: permanently changes the metadata of every listed asset.
Args:
asset_ids: The assets to update.
date_time_original: ISO 8601 datetime applied to all of them.
latitude: GPS latitude, decimal degrees.
longitude: GPS longitude, decimal degrees.
description: Description/caption applied to all of them.
is_favorite: Set favorite status on all of them.
rating: -1 to reject them, or 1 to 5 stars. A rating cannot be cleared
from here, and 0 is not a rating Immich 3.x accepts.
Returns: JSON with success and the number of assets updated.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rating | No | ||
| latitude | No | ||
| asset_ids | Yes | ||
| longitude | No | ||
| description | No | ||
| is_favorite | No | ||
| date_time_original | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |