Skip to main content
POST
/
pages
Create a new page
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    pageFilters: {
      genres: [2],
      keywords: [2],
      media_type: 'movie',
      region: ['<string>'],
      with_runtime_gte: 1,
      with_runtime_lte: 1,
      with_release_date_gte: '2023-12-25',
      with_release_date_lte: '2023-12-25',
      with_watch_providers: ['<string>']
    },
    name: '<string>'
  })
};

fetch('https://api.discovr.media/pages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "pageFilters": {
    "genres": [
      2
    ],
    "keywords": [
      2
    ],
    "media_type": "movie",
    "region": [
      "<string>"
    ],
    "with_runtime_gte": 1,
    "with_runtime_lte": 1,
    "with_release_date_gte": "2023-12-25",
    "with_release_date_lte": "2023-12-25",
    "with_watch_providers": [
      "<string>"
    ]
  }
}

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.

Authorizations

​
Authorization
string
header
required

Bearer token authentication.

  • Identity-tier endpoints (/profiles, /auth/session-token, /auth/session) accept a long-lived refresh token (rt_<hex>).
  • Session-tier endpoints (/pages/*, /profile/*) accept a short-lived session JWT.

SDK clients use two typed API accessors (identityApi() with the refresh token vs sessionApi() with the session JWT) — see the SDK DiscovrAuth helper.

Format: Authorization: Bearer {token}

Body

application/json

Body for POST /pages. The active profile is taken from the session JWT (profileId claim); do not send profileId here.

​
pageFilters
object
​
name
string

Optional human-readable name for the page. When provided, the page can be identified by this name in subsequent GET /pages/:id responses.

Minimum string length: 1

Response

Page created successfully

​
id
string
required

Unique identifier for the page

​
createdAt
string<date-time>
required

Creation timestamp

​
pageFilters
object