# Mediux > Mediux is a community library of artwork for shows, movies, collections and games. The Public API (https://api.mediux.io) reads it anonymously; the Protected API acts for one user with OAuth. Images are served from https://img.mediux.io. Every page is linked as Markdown. Read https://docs-preview.mediux.io/skills/mediux/SKILL.md for the rules an integration must follow, https://docs-preview.mediux.io/llms-full.txt for all guides in one file, and https://docs-preview.mediux.io/openapi.json for the OpenAPI 3.1 document. ## API - [Mediux API](https://docs-preview.mediux.io/api.md): Read Mediux artwork with no sign-up, or act for a user with OAuth. - [Get started](https://docs-preview.mediux.io/api/quickstart.md): Make your first request in a minute, with no account or key. - [Authentication](https://docs-preview.mediux.io/api/authentication.md): Register your app once, then connect users with browser sign-in or the device flow. - [Build with AI](https://docs-preview.mediux.io/api/agents.md): Give your AI coding agent the Mediux docs and integration rules, so what it builds follows them. ## API: Concepts - [Responses and errors](https://docs-preview.mediux.io/api/errors.md): The response envelope, IDs, browser access and every error code. - [Indexes, feeds and pages](https://docs-preview.mediux.io/api/pagination.md): List everything of one type with indexes, follow new artwork with feeds, and page through a creator's work. - [Caching](https://docs-preview.mediux.io/api/caching.md): Reuse responses with ETags, and know how fresh each kind of response is. ## API: Guides - [Build image URLs](https://docs-preview.mediux.io/api/guides/image-urls.md): Turn an image ID from any response into a full-size, resized or JPG image URL. - [Use Set YAML with Kometa](https://docs-preview.mediux.io/api/guides/kometa.md): Apply a show, movie or collection Set's artwork to your Plex library with Kometa. - [Read and edit Lists](https://docs-preview.mediux.io/api/guides/lists.md): Read a user's Lists, check which hold a title, and create, edit and fill Lists for them. - [Draw the Ambient Mesh](https://docs-preview.mediux.io/api/guides/ambient-mesh.md): Paint a title's Ambient Mesh in CSS from the colours in its detail response. ## API: Public API - [Public API](https://docs-preview.mediux.io/api/reference.md): Anonymous read endpoints for titles, Sets, creators, Lists, feeds and YAML exports. - [Retrieve the API configuration](https://docs-preview.mediux.io/api/reference/reference/retrieve-config.md): Returns the artwork languages, closed enums, image size table and error codes. - [Retrieve a Show's Assets](https://docs-preview.mediux.io/api/reference/shows/retrieve-assets.md): Returns every public Asset made for this Show, grouped by slot. - [Retrieve a Show's Sets](https://docs-preview.mediux.io/api/reference/shows/retrieve-sets.md): Returns the Sets made for this Show, newest first. - [Retrieve a Show](https://docs-preview.mediux.io/api/reference/shows/retrieve.md): Returns one Show with its descriptive metadata and Metadata Images. - [Retrieve the Show index](https://docs-preview.mediux.io/api/reference/shows.md): Returns the manifest of the Show index: every non-empty chunk with its path, `itemCount` and newest change. - [Retrieve a Show index chunk](https://docs-preview.mediux.io/api/reference/shows/index-chunk.md): Returns one fixed ID-range chunk of the Show index, ordered by ascending ID. - [Retrieve a Season's Assets](https://docs-preview.mediux.io/api/reference/seasons/retrieve-assets.md): Returns every public Asset made for this Season, grouped by slot. - [Retrieve a Season](https://docs-preview.mediux.io/api/reference/seasons/retrieve.md): Returns one Season with its descriptive metadata and Metadata Images. - [Retrieve an Episode](https://docs-preview.mediux.io/api/reference/episodes/retrieve.md): Returns one Episode with its descriptive metadata. - [Retrieve a Movie's Assets](https://docs-preview.mediux.io/api/reference/movies/retrieve-assets.md): Returns every public Asset made for this Movie, grouped by slot. - [Retrieve a Movie's Sets](https://docs-preview.mediux.io/api/reference/movies/retrieve-sets.md): Returns the Sets made for this Movie, newest first. - [Retrieve a Movie](https://docs-preview.mediux.io/api/reference/movies/retrieve.md): Returns one Movie with its descriptive metadata and Metadata Images. - [Retrieve the Movie index](https://docs-preview.mediux.io/api/reference/movies.md): Returns the manifest of the Movie index: every non-empty chunk with its path, `itemCount` and newest change. - [Retrieve a Movie index chunk](https://docs-preview.mediux.io/api/reference/movies/index-chunk.md): Returns one fixed ID-range chunk of the Movie index, ordered by ascending ID. - [Retrieve a Collection's Assets](https://docs-preview.mediux.io/api/reference/collections/retrieve-assets.md): Returns every public Asset made for this Collection, grouped by slot. - [Retrieve a Collection's Sets](https://docs-preview.mediux.io/api/reference/collections/retrieve-sets.md): Returns the Sets made for this Collection, newest first. - [Retrieve a Collection](https://docs-preview.mediux.io/api/reference/collections/retrieve.md): Returns one Collection with its descriptive metadata and Metadata Images. - [Retrieve the Collection index](https://docs-preview.mediux.io/api/reference/collections.md): Returns the manifest of the Collection index: every non-empty chunk with its path, `itemCount` and newest change. - [Retrieve a Collection index chunk](https://docs-preview.mediux.io/api/reference/collections/index-chunk.md): Returns one fixed ID-range chunk of the Collection index, ordered by ascending ID. - [Retrieve a Person's Assets](https://docs-preview.mediux.io/api/reference/people/retrieve-assets.md): Returns every public Asset made for this Person, grouped by slot. - [Retrieve a Person](https://docs-preview.mediux.io/api/reference/people/retrieve.md): Returns one Person with its descriptive metadata and Metadata Images. - [Retrieve the Person index](https://docs-preview.mediux.io/api/reference/people.md): Returns the manifest of the Person index: every non-empty chunk with its path, `itemCount` and newest change. - [Retrieve a Person index chunk](https://docs-preview.mediux.io/api/reference/people/index-chunk.md): Returns one fixed ID-range chunk of the Person index, ordered by ascending ID. - [Retrieve a Network's Assets](https://docs-preview.mediux.io/api/reference/networks/retrieve-assets.md): Returns every public Asset made for this Network, grouped by slot. - [Retrieve a Network](https://docs-preview.mediux.io/api/reference/networks/retrieve.md): Returns one Network with its descriptive metadata and Metadata Images. - [Retrieve the Network index](https://docs-preview.mediux.io/api/reference/networks.md): Returns the manifest of the Network index: every non-empty chunk with its path, `itemCount` and newest change. - [Retrieve a Network index chunk](https://docs-preview.mediux.io/api/reference/networks/index-chunk.md): Returns one fixed ID-range chunk of the Network index, ordered by ascending ID. - [Retrieve a Company's Assets](https://docs-preview.mediux.io/api/reference/companies/retrieve-assets.md): Returns every public Asset made for this Company, grouped by slot. - [Retrieve a Company](https://docs-preview.mediux.io/api/reference/companies/retrieve.md): Returns one Company with its descriptive metadata and Metadata Images. - [Retrieve the Company index](https://docs-preview.mediux.io/api/reference/companies.md): Returns the manifest of the Company index: every non-empty chunk with its path, `itemCount` and newest change. - [Retrieve a Company index chunk](https://docs-preview.mediux.io/api/reference/companies/index-chunk.md): Returns one fixed ID-range chunk of the Company index, ordered by ascending ID. - [Retrieve a Category's Assets](https://docs-preview.mediux.io/api/reference/categories/retrieve-assets.md): Returns every public Asset made for this Category, grouped by slot. - [Retrieve a Category](https://docs-preview.mediux.io/api/reference/categories/retrieve.md): Returns one Category with its descriptive metadata and Metadata Images. - [Retrieve the Category index](https://docs-preview.mediux.io/api/reference/categories.md): Returns the manifest of the Category index: every non-empty chunk with its path, `itemCount` and newest change. - [Retrieve a Category index chunk](https://docs-preview.mediux.io/api/reference/categories/index-chunk.md): Returns one fixed ID-range chunk of the Category index, ordered by ascending ID. - [Retrieve a Game's Assets](https://docs-preview.mediux.io/api/reference/games/retrieve-assets.md): Returns every public Asset made for this Game, grouped by slot. - [Retrieve a Game's Sets](https://docs-preview.mediux.io/api/reference/games/retrieve-sets.md): Returns the Sets made for this Game, newest first. - [Retrieve a Game](https://docs-preview.mediux.io/api/reference/games/retrieve.md): Returns one Game with its descriptive metadata and Metadata Images. - [Retrieve the Game index](https://docs-preview.mediux.io/api/reference/games.md): Returns the manifest of the Game index: every non-empty chunk with its path, `itemCount` and newest change. - [Retrieve a Game index chunk](https://docs-preview.mediux.io/api/reference/games/index-chunk.md): Returns one fixed ID-range chunk of the Game index, ordered by ascending ID. - [Retrieve a Show Set](https://docs-preview.mediux.io/api/reference/sets/retrieve-show-set.md): Returns one Show Set: its header and a sparse Entity tree of the artwork it holds. - [Retrieve a Movie Set](https://docs-preview.mediux.io/api/reference/sets/retrieve-movie-set.md): Returns one Movie Set: its header and a sparse Entity tree of the artwork it holds. - [Retrieve a Collection Set](https://docs-preview.mediux.io/api/reference/sets/retrieve-collection-set.md): Returns one Collection Set: its header and a sparse Entity tree of the artwork it holds. - [Retrieve a Game Set](https://docs-preview.mediux.io/api/reference/sets/retrieve-game-set.md): Returns one Game Set: its header and a sparse Entity tree of the artwork it holds. - [Retrieve Show Set YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-show-set-yaml.md): Returns the Show Set as Kometa-ready YAML. - [Retrieve Show Set Original YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-show-set-original-yaml.md): Returns the Show Set as Kometa-ready YAML with Original image URLs. - [Retrieve Movie Set YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-movie-set-yaml.md): Returns the Movie Set as Kometa-ready YAML. - [Retrieve Movie Set Original YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-movie-set-original-yaml.md): Returns the Movie Set as Kometa-ready YAML with Original image URLs. - [Retrieve Collection Set YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-collection-set-yaml.md): Returns the Collection Set as Kometa-ready YAML. - [Retrieve Collection Set Original YAML](https://docs-preview.mediux.io/api/reference/sets/retrieve-collection-set-original-yaml.md): Returns the Collection Set as Kometa-ready YAML with Original image URLs. - [Retrieve a Boxset](https://docs-preview.mediux.io/api/reference/boxsets-and-loadouts/retrieve-boxset.md): Returns one Boxset with its poster and member Show, Movie and Collection Sets. - [Retrieve a Loadout](https://docs-preview.mediux.io/api/reference/boxsets-and-loadouts/retrieve-loadout.md): Returns one Loadout with its poster and member Game Sets. - [Retrieve an Asset](https://docs-preview.mediux.io/api/reference/assets/retrieve.md): Returns one public Asset by ID, including standalone Assets. - [Retrieve the creators directory](https://docs-preview.mediux.io/api/reference/profiles.md): Returns the manifest of the creators directory: every bucket with its path and creator count. - [Retrieve a creators directory bucket](https://docs-preview.mediux.io/api/reference/profiles/index-chunk.md): Returns one UUID-prefix bucket of the creators directory, ordered by ascending User ID. - [Retrieve a User Profile](https://docs-preview.mediux.io/api/reference/profiles/retrieve.md): Returns a creator's public profile with lifetime totals and page counts. - [List a creator's Sets](https://docs-preview.mediux.io/api/reference/profiles/list-sets.md): Returns one page of a creator's Sets, newest first. - [List a creator's Boxsets](https://docs-preview.mediux.io/api/reference/profiles/list-boxsets.md): Returns one page of a creator's Boxsets, newest first. - [List a creator's Loadouts](https://docs-preview.mediux.io/api/reference/profiles/list-loadouts.md): Returns one page of a creator's Loadouts, newest first. - [List a creator's Assets](https://docs-preview.mediux.io/api/reference/profiles/list-assets.md): Returns one page of a creator's Assets, newest first. - [List a creator's Public Lists](https://docs-preview.mediux.io/api/reference/profiles/list-lists.md): Returns one page of a creator's Public Lists, newest first. - [Retrieve the List discovery index](https://docs-preview.mediux.io/api/reference/lists.md): Returns the manifest of Public List discovery: every non-empty bucket with its path and List count. - [Retrieve a List discovery bucket](https://docs-preview.mediux.io/api/reference/lists/index-chunk.md): Returns one UUID-prefix bucket of Public List discovery, ordered by ascending List ID. - [Retrieve a List](https://docs-preview.mediux.io/api/reference/lists/retrieve.md): Returns a Public List: its header and, for a Media or Game List, every title with its top-level poster; an Asset List returns its images. - [Retrieve a List title](https://docs-preview.mediux.io/api/reference/lists/retrieve-title.md): Returns one title of a Public Media or Game List with its chosen Assets, including Season and Episode choices. - [List today's Media Sets](https://docs-preview.mediux.io/api/reference/feeds/list-media-sets.md): Returns the Show, Movie and Collection Sets changed today (UTC), newest first. - [List Media Sets changed on a day](https://docs-preview.mediux.io/api/reference/feeds/list-media-sets-day.md): Returns the Show, Movie and Collection Sets changed on one UTC day, newest first. - [Retrieve the Media Set feed as Atom](https://docs-preview.mediux.io/api/reference/feeds/retrieve-media-sets-atom.md): Returns the Show, Movie and Collection Sets changed in the last 3 days as an Atom feed. - [List today's Game Sets](https://docs-preview.mediux.io/api/reference/feeds/list-game-sets.md): Returns the Game Sets changed today (UTC), newest first. - [List Game Sets changed on a day](https://docs-preview.mediux.io/api/reference/feeds/list-game-sets-day.md): Returns the Game Sets changed on one UTC day, newest first. - [Retrieve the Game Set feed as Atom](https://docs-preview.mediux.io/api/reference/feeds/retrieve-game-sets-atom.md): Returns the Game Sets changed in the last 3 days as an Atom feed. ## API: Protected API - [Protected API](https://docs-preview.mediux.io/api/account.md): Read and manage one user's Lists, follows and notifications with their permission. - [List relationships](https://docs-preview.mediux.io/api/reference/relationships/list.md): Lists the Users you follow or hide, newest first. - [Follow or hide a User](https://docs-preview.mediux.io/api/reference/relationships/set.md): Sets your relationship with a User to `follow` or `hide`. - [Clear a relationship](https://docs-preview.mediux.io/api/reference/relationships/clear.md): Removes your follow or hide of a User. - [Get the connected User](https://docs-preview.mediux.io/api/reference/account-identity/get.md): Returns the User your app is connected to and the scopes your token holds. - [List your Lists](https://docs-preview.mediux.io/api/reference/account-lists/list.md): Lists the user's own Lists, then the Public Lists they subscribe to. - [Create a List](https://docs-preview.mediux.io/api/reference/account-lists/create.md): Creates a private or Public List of one kind for the user. - [Find your Lists holding a title](https://docs-preview.mediux.io/api/reference/account-lists/membership.md): Returns the user's own Media and Game Lists that hold one title. - [Get one of your Lists](https://docs-preview.mediux.io/api/reference/account-lists/retrieve.md): Returns a List the user owns or subscribes to, in the public List shape. - [Edit one of your Lists](https://docs-preview.mediux.io/api/reference/account-lists/update.md): Changes the name, description or visibility of a List the user owns. - [Get a title in one of your Lists](https://docs-preview.mediux.io/api/reference/account-lists/retrieve-title.md): Returns one title of a Media or Game List the user owns or subscribes to, with its chosen Assets. - [Add titles to a List](https://docs-preview.mediux.io/api/reference/account-lists/add-titles.md): Adds Shows, Movies, Collections or Games to a Media or Game List the user owns. - [Remove titles from a List](https://docs-preview.mediux.io/api/reference/account-lists/remove-titles.md): Removes titles from a Media or Game List the user owns. - [Add Assets to an Asset List](https://docs-preview.mediux.io/api/reference/account-lists/add-assets.md): Adds Assets (single community images) to an Asset List the user owns. - [Remove Assets from an Asset List](https://docs-preview.mediux.io/api/reference/account-lists/remove-assets.md): Removes Assets from an Asset List the user owns. - [Subscribe to or leave a Public List](https://docs-preview.mediux.io/api/reference/account-lists/set-subscription.md): Subscribes the user to another User's Public List, or ends the subscription. - [List your Notifications](https://docs-preview.mediux.io/api/reference/notifications/list.md): Lists the user's Notifications, newest first. - [Mark Notifications read](https://docs-preview.mediux.io/api/reference/notifications/mark-read.md): Marks some or all of the user's Notifications read. ## Help - [Using Mediux](https://docs-preview.mediux.io/guides.md): Find, choose and download community artwork for your media library. - [Publishing artwork](https://docs-preview.mediux.io/guides/publishing.md): Upload Sets, group them into Boxsets and Loadouts, and handle artwork requests. - [Your account](https://docs-preview.mediux.io/guides/account.md): Sign in, manage settings and notifications, connect apps, or delete your account.