Search random assets
immich_search_randomRetrieve a random selection of Immich assets by applying filters like type, date, location, people, tags, or rating. Use it to surface unexpected photos or videos matching specific criteria.
Instructions
Search random assets
Retrieve a random selection of assets based on the provided criteria.
Immich operation: POST /search/random · tag: Search
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "immich_search_random"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ocr | No | ocr (request body) | |
| city | No | city (request body) | |
| make | No | make (request body) | |
| size | No | size (request body) | |
| type | No | type (request body) | |
| model | No | model (request body) | |
| state | No | state (request body) | |
| filter | No | filter (request body) | |
| rating | No | rating (request body) | |
| tagIds | No | tagIds (request body) | |
| country | No | country (request body) | |
| albumIds | No | albumIds (request body) | |
| isMotion | No | isMotion (request body) | |
| withExif | No | withExif (request body) | |
| isEncoded | No | isEncoded (request body) | |
| isOffline | No | isOffline (request body) | |
| lensModel | No | lensModel (request body) | |
| libraryId | No | libraryId (request body) | |
| personIds | No | personIds (request body) | |
| isFavorite | No | isFavorite (request body) | |
| takenAfter | No | takenAfter (request body) | |
| visibility | No | visibility (request body) | |
| withPeople | No | withPeople (request body) | |
| takenBefore | No | takenBefore (request body) | |
| withDeleted | No | withDeleted (request body) | |
| withStacked | No | withStacked (request body) | |
| createdAfter | No | createdAfter (request body) | |
| isNotInAlbum | No | isNotInAlbum (request body) | |
| trashedAfter | No | trashedAfter (request body) | |
| updatedAfter | No | updatedAfter (request body) | |
| createdBefore | No | createdBefore (request body) | |
| trashedBefore | No | trashedBefore (request body) | |
| updatedBefore | No | updatedBefore (request body) |