---
title: "Applies search criteria to an item and refreshes metadata."
method: POST
path: "/Items/RemoteSearch/Apply/{itemId}"
tags: ["ItemLookup"]
---

# Applies search criteria to an item and refreshes metadata.

`POST /Items/RemoteSearch/Apply/{itemId}`

## Path parameters

- `itemId` string, uuid, required — Item id.

## Query parameters

- `replaceAllImages` boolean — Optional. Whether or not to replace all images. Default: True.

## Request body

- RemoteSearchResult
  - `Name` string, nullable — Gets or sets the name.
  - `ProviderIds` object, nullable — Gets or sets the provider ids.
  - `ProductionYear` integer, nullable — Gets or sets the year.
  - `IndexNumber` integer, nullable
  - `IndexNumberEnd` integer, nullable
  - `ParentIndexNumber` integer, nullable
  - `PremiereDate` string, date-time, nullable
  - `ImageUrl` string, nullable
  - `SearchProviderName` string, nullable
  - `Overview` string, nullable
  - `AlbumArtist` RemoteSearchResult — recursive
  - `Artists` RemoteSearchResult[], nullable

## Response `204`

Item metadata refreshed.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/jellyfin/apis/jellyfin-api.md) · [All operations](https://skmtc.net/jellyfin/apis/jellyfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jellyfin/jellyfin-api/versions/eb6f75af7066/schema)