media_list

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/wikimedia/json-schema/wikimedia-media-list-schema.json",
  "title": "media_list",
  "x-generated": "2026-11-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/wikimedia-page-content-api-openapi.yml#/components/schemas/media_list",
  "type": "object",
  "properties": {
    "revision": {
      "type": "string",
      "description": "the revision ID used to create the list"
    },
    "tid": {
      "type": "string",
      "description": "the time uuid of the page rendering used to create the list"
    },
    "items": {
      "type": "array",
      "description": "a list of media items",
      "items": {
        "$ref": "#/$defs/media_item"
      }
    }
  },
  "required": [
    "items",
    "revision",
    "tid"
  ],
  "$defs": {
    "media_item": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "The file page title"
        },
        "type": {
          "type": "string",
          "enum": [
            "image",
            "video",
            "audio"
          ]
        },
        "section_id": {
          "type": "integer",
          "description": "section ID in which the item is found on the page"
        },
        "showInGallery": {
          "type": "boolean",
          "description": "whether the client should show the file in an image gallery presentation"
        },
        "caption": {
          "type": "object",
          "properties": {
            "html": {
              "type": "string",
              "description": "on-wiki caption for the media item, including all HTML markup"
            },
            "text": {
              "type": "string",
              "description": "plain text of the on-wiki caption for the media item"
            }
          }
        },
        "original": {
          "type": "object",
          "description": "reference to a Mathoid-rendered math formula image",
          "properties": {
            "source": {
              "type": "string",
              "description": "Mathoid image render URL"
            },
            "mime": {
              "type": "string",
              "description": "the Mathoid image mime type"
            }
          }
        }
      },
      "required": [
        "type",
        "section_id",
        "showInGallery"
      ]
    }
  }
}