# Dev/API Corner **URL:** https://forums.plex.tv/c/dev-community/dev-api-corner/61.md [Latest](https://forums.plex.tv/latest.md) · [Categories](https://forums.plex.tv/categories.md) · [Tags](https://forums.plex.tv/tags.md) --- ## [About the Dev/API Corner category](https://forums.plex.tv/t/about-the-dev-api-corner-category/273995)
**Author:** [@system](https://forums.plex.tv/u/system)\ **Replies:** 0\ **Last updated:** [June 21, 2018, 11:11pm UTC](https://forums.plex.tv/t/about-the-dev-api-corner-category/273995 "2018-06-21T23:11:11Z")
This forum is for conversation, questions, and feedback in regards to the development of community built apps and tools utilizing the Public API You might want look at https://developer.plex.tv/ for information about th… --- ## [Does Plex have an official MCP integration available or planned?](https://forums.plex.tv/t/does-plex-have-an-official-mcp-integration-available-or-planned/943819)
**Author:** [@Tim-May](https://forums.plex.tv/u/Tim-May)\ **Replies:** 0\ **Last updated:** [October 2, 2026, 2:42pm UTC](https://forums.plex.tv/t/does-plex-have-an-official-mcp-integration-available-or-planned/943819 "2026-10-02T14:42:37Z")
Hi everyone, I’m looking into a small project that would let an AI assistant search my Plex library and eventually play music through Plexamp on my Android phone. Before I get too far, I wanted to check whether Plex alr… --- ## [Companion timeline stays stale: PMS proxy does not expose X-Plex-Client-Identifier](https://forums.plex.tv/t/companion-timeline-stays-stale-pms-proxy-does-not-expose-x-plex-client-identifier/943091)
**Author:** [@trentnix](https://forums.plex.tv/u/trentnix)\ **Replies:** 0\ **Last updated:** [September 19, 2026, 9:04pm UTC](https://forums.plex.tv/t/companion-timeline-stays-stale-pms-proxy-does-not-expose-x-plex-client-identifier/943091 "2026-09-19T21:04:29Z")
Server Version#: 1.43.4.10903-e5521bd8c, running on TrueNAS. Player Version#: Bundled Plex Web: 4.160.0. I’m implementing Plex Companion support in MiSTerVision, a third-party player for MiSTer hardware. Playback and s… --- ## [Guidance for an independent Plex client: APIs, entitlements and naming](https://forums.plex.tv/t/guidance-for-an-independent-plex-client-apis-entitlements-and-naming/942877)
**Author:** [@amitoj9896](https://forums.plex.tv/u/amitoj9896)\ **Replies:** 0\ **Last updated:** [September 14, 2026, 10:37pm UTC](https://forums.plex.tv/t/guidance-for-an-independent-plex-client-apis-entitlements-and-naming/942877 "2026-09-14T22:37:48Z")
Hi Plex team, I’m developing Xelp, a free personal hobby project: an independent native client for Plex movie and TV libraries on iPhone, iPad, Mac and Apple TV. I’m reviewing the project to ensure its integrations and… --- ## [Plex watch history incomplete unless 1 episode is first marked as watched](https://forums.plex.tv/t/plex-watch-history-incomplete-unless-1-episode-is-first-marked-as-watched/942372)
**Author:** [@Matt\_Weed](https://forums.plex.tv/u/Matt_Weed)\ **Replies:** 4\ **Last updated:** [September 10, 2026, 3:14am UTC](https://forums.plex.tv/t/plex-watch-history-incomplete-unless-1-episode-is-first-marked-as-watched/942372 "2026-09-10T03:14:06Z")
Server Version#: Version 4.160.0 Player Version#: website I have found that using the following API does not return correct results for TV Shows under certain conditions: http://{ip\_address}:32400/library/sections/{se… --- ## [\[REL\] Adult DVD Empire Metadata Agent 2025](https://forums.plex.tv/t/rel-adult-dvd-empire-metadata-agent-2025/926107)
**Author:** [@TippTopp](https://forums.plex.tv/u/TippTopp)\ **Replies:** 1\ **Last updated:** [August 30, 2026, 9:07pm UTC](https://forums.plex.tv/t/rel-adult-dvd-empire-metadata-agent-2025/926107 "2026-08-30T21:07:21Z")
Plex metadata agent for fetching metadata for AdultDVDEmpire material. Change Log: 2026-07-29 - v1.1.2 Plex sandbox crash fix Bug fix Metadata update aborted with no title/poster/art - Plex Framework does not define g… --- ## [Exchanging PIN for JWT Token](https://forums.plex.tv/t/exchanging-pin-for-jwt-token/941120)
**Author:** [@peardox](https://forums.plex.tv/u/peardox)\ **Replies:** 1\ **Last updated:** [August 27, 2026, 7:45pm UTC](https://forums.plex.tv/t/exchanging-pin-for-jwt-token/941120 "2026-08-27T19:45:45Z")
Following the docs at https://developer.plex.tv/pms/#section/API-Info/Authenticating-with-Plex I get everything going fine until I hit the last step and try exchanging my PIN for a JWT Token Using the link page at https… --- ## [Question on https://clients.plex.tv/api/v2/resources and JWT authentication](https://forums.plex.tv/t/question-on-https-clients-plex-tv-api-v2-resources-and-jwt-authentication/934478)
**Author:** [@clambin](https://forums.plex.tv/u/clambin)\ **Replies:** 4\ **Last updated:** [August 25, 2026, 12:35pm UTC](https://forums.plex.tv/t/question-on-https-clients-plex-tv-api-v2-resources-and-jwt-authentication/934478 "2026-08-25T12:35:16Z")
Hi! I maintain a Go client for the Plex API and I’m in the process of implementing JWT authentication. One of the things I’m trying to do is look up the registered PMS servers to get the token for the PMS server. Prev… --- ## [Refresh Queue when on Cell NOT wifi so NO Port 32500](https://forums.plex.tv/t/refresh-queue-when-on-cell-not-wifi-so-no-port-32500/938381)
**Author:** [@pdressler](https://forums.plex.tv/u/pdressler)\ **Replies:** 1\ **Last updated:** [August 21, 2026, 7:42am UTC](https://forums.plex.tv/t/refresh-queue-when-on-cell-not-wifi-so-no-port-32500/938381 "2026-08-21T07:42:52Z")
Hey all, New here and stuck. I have a plex media server running well. I use PlexAmp on my phone mostly in the car over android auto. While Gemini will Play a song for me it will not queue so I built it. Gemini is still… --- ## [Generating a client from openapi spec?](https://forums.plex.tv/t/generating-a-client-from-openapi-spec/941767)
**Author:** [@clambin](https://forums.plex.tv/u/clambin)\ **Replies:** 1\ **Last updated:** [August 18, 2026, 3:20pm UTC](https://forums.plex.tv/t/generating-a-client-from-openapi-spec/941767 "2026-08-18T15:20:37Z")
Has anyone tried to generate a client from the published openapi spec? I had to wait for my generator to support openapi v3.1, but it doesn’t work: error generating code: error generating code for type definitions: du… --- ## [Updating library section location paths via PUT api returns 200 but seems to do nothing](https://forums.plex.tv/t/updating-library-section-location-paths-via-put-api-returns-200-but-seems-to-do-nothing/941720)
**Author:** [@allieoctothodes](https://forums.plex.tv/u/allieoctothodes)\ **Replies:** 3\ **Last updated:** [August 16, 2026, 10:06pm UTC](https://forums.plex.tv/t/updating-library-section-location-paths-via-put-api-returns-200-but-seems-to-do-nothing/941720 "2026-08-16T22:06:18Z")
Hello! I am trying to automate the process of provisioning a new drive for my Plex set up, and that means looping through my existing library sections and PUTting an update to the section’s locations to add all the new … --- ## [PMS returns bare 400 Bad Request on /subtitles/:/transcode/universal/start for a 3rd-party webOS cli](https://forums.plex.tv/t/pms-returns-bare-400-bad-request-on-subtitles-transcode-universal-start-for-a-3rd-party-webos-cli/940051)
**Author:** [@alec\_hh](https://forums.plex.tv/u/alec_hh)\ **Replies:** 0\ **Last updated:** [June 27, 2026, 2:48am UTC](https://forums.plex.tv/t/pms-returns-bare-400-bad-request-on-subtitles-transcode-universal-start-for-a-3rd-party-webos-cli/940051 "2026-06-27T02:48:48Z")
Setup: I’m building a third-party Plex client for LG webOS 4 (B8, Chrome 53). Goal: render an embedded, keyless text subtitle (SRT inside an MKV) client-side while the video Direct Plays — exactly what the official “Plex… --- ## [Add items to a Collection using Plex API](https://forums.plex.tv/t/add-items-to-a-collection-using-plex-api/939886)
**Author:** [@wouter\_o](https://forums.plex.tv/u/wouter_o)\ **Replies:** 3\ **Last updated:** [June 21, 2026, 5:39pm UTC](https://forums.plex.tv/t/add-items-to-a-collection-using-plex-api/939886 "2026-06-21T17:39:35Z")
I’m writing an c# application to create and manage Collections using the Plex API. I’ve managed to iterate and list my Plex library and Collections, but creating new Collections and adding items to existing collections g… --- ## [Support and document all the fields with includeOptionalFields for the /all endpoints](https://forums.plex.tv/t/support-and-document-all-the-fields-with-includeoptionalfields-for-the-all-endpoints/931534)
**Author:** [@Tolriq](https://forums.plex.tv/u/Tolriq)\ **Replies:** 6\ **Last updated:** [June 13, 2026, 7:43am UTC](https://forums.plex.tv/t/support-and-document-all-the-fields-with-includeoptionalfields-for-the-all-endpoints/931534 "2026-06-13T07:43:27Z")
Now that the API is public can I ask again to have a way to request more fields to the /all endpoints ? Currently to get albums or artists moods, styles, album types we need to issue a request to each item. Being able … --- ## [Request: Stable and versioned API URL](https://forums.plex.tv/t/request-stable-and-versioned-api-url/939305)
**Author:** [@TechSquidTV](https://forums.plex.tv/u/TechSquidTV)\ **Replies:** 0\ **Last updated:** [May 31, 2026, 3:43pm UTC](https://forums.plex.tv/t/request-stable-and-versioned-api-url/939305 "2026-05-31T15:43:23Z")
The current Plex API reDoc docs can be found at https://developer.plex.tv/pms/ but the actual OpenAPI spec lives (currently) at “blob:https://developer.plex.tv/d0d815bf-a2e4-45e5-bc7e-1f2311f53a56” This appears to be an… --- ## [Can season-level metadata (year, rating, runtime, cast) be set via API to appear in Apple TV home sc](https://forums.plex.tv/t/can-season-level-metadata-year-rating-runtime-cast-be-set-via-api-to-appear-in-apple-tv-home-sc/939256)
**Author:** [@Asher77](https://forums.plex.tv/u/Asher77)\ **Replies:** 3\ **Last updated:** [May 29, 2026, 6:57pm UTC](https://forums.plex.tv/t/can-season-level-metadata-year-rating-runtime-cast-be-set-via-api-to-appear-in-apple-tv-home-sc/939256 "2026-05-29T18:57:08Z")
I have a library of miniseries/single-season shows. On the Apple TV Plex app, the Recently Added row shows a season card for these shows rather than a show card. I’ve been using the Plex API to copy show-level metadata … --- ## [Please include live TV in the standard "sections" of the Plex server API](https://forums.plex.tv/t/please-include-live-tv-in-the-standard-sections-of-the-plex-server-api/765174)
**Author:** [@0xCBF](https://forums.plex.tv/u/0xCBF)\ **Replies:** 1\ **Last updated:** [May 28, 2026, 12:23pm UTC](https://forums.plex.tv/t/please-include-live-tv-in-the-standard-sections-of-the-plex-server-api/765174 "2026-05-28T12:23:11Z")
One great feature of the plex API is the ability to play media to a plex client. Unfortunately, because the Plex Live TV section does not appear in the sections, calling a TV channel is not possible. I think it would be… --- ## [Weird ressourcehash & certificate problem with agent](https://forums.plex.tv/t/weird-ressourcehash-certificate-problem-with-agent/939186)
**Author:** [@rossinior](https://forums.plex.tv/u/rossinior)\ **Replies:** 16\ **Last updated:** [May 27, 2026, 10:48pm UTC](https://forums.plex.tv/t/weird-ressourcehash-certificate-problem-with-agent/939186 "2026-05-27T22:48:11Z")
Hi @drzoidberg33 I value your knowledge and your ability to support very much, so I hope that you can help me solving a problem. I am still using the legacy agents with several self-written agents. I am in the process o… --- ## [Possible bug in PMS API](https://forums.plex.tv/t/possible-bug-in-pms-api/939051)
**Author:** [@HTPC\_Lover](https://forums.plex.tv/u/HTPC_Lover)\ **Replies:** 2\ **Last updated:** [May 22, 2026, 8:48am UTC](https://forums.plex.tv/t/possible-bug-in-pms-api/939051 "2026-05-22T08:48:28Z")
Since the latest releases the Web-API seems to be broken. I’m using the API calls you can find on https://developer.plex.tv/ to walk through libraries and export some data. My scripts were running unmodified since year… --- ## [Irreconcilable date in api/v2/user response](https://forums.plex.tv/t/irreconcilable-date-in-api-v2-user-response/938959)
**Author:** [@michealespinola](https://forums.plex.tv/u/michealespinola)\ **Replies:** 0\ **Last updated:** [May 19, 2026, 9:14pm UTC](https://forums.plex.tv/t/irreconcilable-date-in-api-v2-user-response/938959 "2026-05-19T21:14:42Z")
Interrogating https://plex.tv/api/v2/user is returning a value that I cannot reconcile in regards to my own known account information. My user attribute joinedAt (‘1413264741’) appears to be accurate. However, my subscr… --- ## [Custom TMDB example agent does not pass TV series ratings to Plex](https://forums.plex.tv/t/custom-tmdb-example-agent-does-not-pass-tv-series-ratings-to-plex/936068)
**Author:** [@peiftronica](https://forums.plex.tv/u/peiftronica)\ **Replies:** 6\ **Last updated:** [May 19, 2026, 8:16pm UTC](https://forums.plex.tv/t/custom-tmdb-example-agent-does-not-pass-tv-series-ratings-to-plex/936068 "2026-05-19T20:16:19Z")
When using the custom TMDB metadata agent found at GitHub - plexinc/tmdb-example-provider for a TV library, series ratings are not being passed to Plex correctly. They do seem to be stored in a ratings array, but they do… --- ## [Question about Intro/Credits provider/plugin support](https://forums.plex.tv/t/question-about-intro-credits-provider-plugin-support/938786)
**Author:** [@Pasithea](https://forums.plex.tv/u/Pasithea)\ **Replies:** 9\ **Last updated:** [May 13, 2026, 10:47pm UTC](https://forums.plex.tv/t/question-about-intro-credits-provider-plugin-support/938786 "2026-05-13T22:47:58Z")
I’m developing TheIntroDB, a community supported database for intro, recap, credits, and preview segment times. I would love to integrate TIDB into Plex, but I’m finding conflicting information about plugin support and … --- ## [\[Announcement\] Custom Metadata Providers](https://forums.plex.tv/t/announcement-custom-metadata-providers/934384)
**Author:** [@drzoidberg33](https://forums.plex.tv/u/drzoidberg33)\ **Replies:** 88\ **Last updated:** [May 8, 2026, 11:49am UTC](https://forums.plex.tv/t/announcement-custom-metadata-providers/934384 "2026-05-08T11:49:15Z")
Note: This post is primarily focused towards developers who are looking to implement their own custom metadata agents, however there is nothing preventing anyone interested from taking a look through here if they find th… --- ## [Need Testers for a new Poster API](https://forums.plex.tv/t/need-testers-for-a-new-poster-api/938510)
**Author:** [@andreabezio](https://forums.plex.tv/u/andreabezio)\ **Replies:** 0\ **Last updated:** [May 2, 2026, 11:34am UTC](https://forums.plex.tv/t/need-testers-for-a-new-poster-api/938510 "2026-05-02T11:34:59Z")
First of all, huge thanks to the Plex developers for creating a simple yet effective way to integrate external metadata through Custom Metadata Providers. Using this system, I’ve integrated my new poster API, TOP Poster… --- ## [I want to use the server API to change the play queue in the macos plex player](https://forums.plex.tv/t/i-want-to-use-the-server-api-to-change-the-play-queue-in-the-macos-plex-player/937655)
**Author:** [@newmilo41](https://forums.plex.tv/u/newmilo41)\ **Replies:** 1\ **Last updated:** [April 25, 2026, 9:42pm UTC](https://forums.plex.tv/t/i-want-to-use-the-server-api-to-change-the-play-queue-in-the-macos-plex-player/937655 "2026-04-25T21:42:17Z")
Server Version#: 1.43.0.10492 Player Version#: 1.112.0.359-0d79a49f I am trying to build desktop app that uses the Plex server API to do certain things, such as setting ratings, applying tags etc, while media is playin… --- ## [Alternative to using /player/playback/playMedia](https://forums.plex.tv/t/alternative-to-using-player-playback-playmedia/938340)
**Author:** [@darkstorm1308](https://forums.plex.tv/u/darkstorm1308)\ **Replies:** 0\ **Last updated:** [April 25, 2026, 9:24pm UTC](https://forums.plex.tv/t/alternative-to-using-player-playback-playmedia/938340 "2026-04-25T21:24:34Z")
Hi all, I’ve recently built an application that turns plex into a custom private personalised radio station based off my music collection. It essentially builds a curated list of x number of tracks and inserts radio DJ… --- ## [API for new list functionnality](https://forums.plex.tv/t/api-for-new-list-functionnality/937803)
**Author:** [@Bysev](https://forums.plex.tv/u/Bysev)\ **Replies:** 5\ **Last updated:** [April 25, 2026, 7:07pm UTC](https://forums.plex.tv/t/api-for-new-list-functionnality/937803 "2026-04-25T19:07:01Z")
Hi! I know there is an API even though not everything is correctly documented. I also know Plex recently released lists. Does anybody know if there is a way to call the API to get what’s inside one of those lists? Th… --- ## [Plex API - get show metadata with folder location and possibly extras](https://forums.plex.tv/t/plex-api-get-show-metadata-with-folder-location-and-possibly-extras/938006)
**Author:** [@umamaheshwarreddy](https://forums.plex.tv/u/umamaheshwarreddy)\ **Replies:** 4\ **Last updated:** [April 23, 2026, 1:27am UTC](https://forums.plex.tv/t/plex-api-get-show-metadata-with-folder-location-and-possibly-extras/938006 "2026-04-23T01:27:15Z")
I am trying to get the library items metadata from plex API (referencing https://developer.plex.tv/pms/). Here’s what I have done so far: Got the Auth Token Request figured out - successfully able to use OAuth to get … --- ## [includeFields not working as described in the documentation](https://forums.plex.tv/t/includefields-not-working-as-described-in-the-documentation/938211)
**Author:** [@Soleous](https://forums.plex.tv/u/Soleous)\ **Replies:** 0\ **Last updated:** [April 21, 2026, 10:35pm UTC](https://forums.plex.tv/t/includefields-not-working-as-described-in-the-documentation/938211 "2026-04-21T22:35:27Z")
I am looking to make some performance tweaks and am trying to reduce the fields down to only what is needed. The includeFields parameter has been renamed to includeOptionalFields. The includeFields parameter now means … --- ## [Metadata requests for Extras, ie plex/metadata/show-id/extras](https://forums.plex.tv/t/metadata-requests-for-extras-ie-plex-metadata-show-id-extras/936949)
**Author:** [@peter.a.bayliss](https://forums.plex.tv/u/peter.a.bayliss)\ **Replies:** 1\ **Last updated:** [April 12, 2026, 4:06pm UTC](https://forums.plex.tv/t/metadata-requests-for-extras-ie-plex-metadata-show-id-extras/936949 "2026-04-12T16:06:16Z")
Developing my Custom Provider Agent and want to accommodate the “/extras“ on a show request. I think I understand the placing of all the files in each level (show/season/episode) from here Local Files for TV Show Traile… [Next page](https://forums.plex.tv/c/dev-community/dev-api-corner/61.md?page=1)