Documentation Index
Fetch the complete documentation index at: https://docs.discovr.media/llms.txt
Use this file to discover all available pages before exploring further.
CreatePagePayload
Body for POST /pages. The active profile is taken from the session JWT
(profileId claim); do not send profileId here.
| Property | Type | Required | Description |
|---|
| pageFilters | object | No | |
| name | string | No | Optional human-readable name for the page. When provided, the page can be identified by this name in subsequent GET /pages/:id responses. |
| Property | Type | Required | Description |
|---|
| id | string | Yes | Unique identifier for the page |
| createdAt | string | Yes | Creation timestamp |
| pageFilters | object | No | |
FilterSpec
| Property | Type | Required | Description |
|---|
| genres | integer[] | No | Genre IDs to filter by |
| keywords | integer[] | No | Keyword IDs to filter by |
| media_type | "movie" | "tv" | "all" | No | Media type filter |
| region | string[] | No | Region codes (e.g., “US”, “GB”) |
| with_runtime_gte | integer | No | Minimum runtime in minutes |
| with_runtime_lte | integer | No | Maximum runtime in minutes |
| with_release_date_gte | string | No | Earliest release date (YYYY-MM-DD) |
| with_release_date_lte | string | No | Latest release date (YYYY-MM-DD) |
| with_watch_providers | string[] | No | Streaming provider IDs |
HeroItem
A MediaItem specifically for hero sections. Extends MediaItem but requires
the overview and logo_path fields to always be present (may be null, but fields must exist).
Hero items always include overview text from TMDB for display in hero carousels.
Page
| Property | Type | Required | Description |
|---|
| id | string | Yes | Unique identifier for the page |
| createdAt | string | Yes | Creation timestamp |
| hero | HeroItem[] | Yes | Array of exactly 10 popular HeroItems for the hero section |
| name | string | No | Human-readable page title as a breadcrumb path (e.g. “Movies & Series • Anime • Fantasy”). Only present for pages derived from a page graph node (genre/keyword navigation pages). Absent for top-level pages (home, movies, series). |
