+- Jellyfin Forum (https://forum.jellyfin.org)
+-- Forum: Support (https://forum.jellyfin.org/f-support)
+--- Forum: General Questions (https://forum.jellyfin.org/f-general-questions)
+--- Thread: API endpoint to modify metadata (/t-api-endpoint-to-modify-metadata)
API endpoint to modify metadata - chipiguay - 2025-11-01
Hi,
1st post here, so allow me to introduce myself: I'm Pablo, writing from Spain. I've self hosted jellyfin for around 5 years now. Very happy with it! Thank you everyone involved!
I have some children and I'd like to apply a custom parental rating in parallel to "parental rating". I don't know the original name of this other field (valoracion personal in the Spanish UI), but so far I've used it to set the rating of some content for children. The thing is I recently learned of common sense media, which maintain a DB which makes a lot of sense if you ask me, and I'd like pretty much apply their rating through this custom parental rating field.
To do so, I was planning to do some code that would do that for me. However, there are just too many endpoints in the swagger and I couldn't figure it out so far. And that's why I'm posting this. Can anyone maybe give me some tips for my journey?
Much appreciated,
Pablo.
RE: API endpoint to modify metadata - chipiguay - 2025-12-21
Hi all!
I found what endpoint I need to use:
- <url>/Items
with both GET and POST requests.
I hit however another wall: I can fetch the data but I cannot update the details.
The POST request I'm using is as follows:
Headers:
- Authorization: MediaBrowser Token="{TOKEN}"
- Accept: application/json; charset=utf-8
- Content-Type: application/json
- Accept-Encoding: text/plain
- Accept: '*'
Url:
- https://<my-server>/items/<itemId>
Data:
- {"CustomRating": "13"}
Response is:
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"$":["\u0027C\u0027 is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0."],"request":["The request field is required."]},"traceId":"00-c4537c18c628d487cd49a2429ad69e1e-a5d9afd2eff4f505-00"}
I get the data payload I'm sending is not what the server expects, but the docs (https://api.jellyfin.org/#tag/ItemUpdate/operation/UpdateItem) I'm checking don't provide any further details on this regard.
In case anyone is curious, so far my code is here: https://codeberg.org/elfio/common-sense-media-jellyfin/
Feedback is welcome! :pray: