MessageMediaResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/elocuenti-com/json-schema/elocuenti-com-message-media-response-schema.json",
  "title": "MessageMediaResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/elocuenti-com-messages-api-openapi.yml#/components/schemas/MessageMediaResponse",
  "type": "object",
  "properties": {
    "data": {
      "$ref": "#/$defs/MessageMedia"
    },
    "request_id": {
      "type": "string",
      "description": "The identifier of this request. Give it to support if you need help.",
      "title": "Request Id"
    }
  },
  "required": [
    "data",
    "request_id"
  ],
  "$defs": {
    "MessageMedia": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The identifier of the message.",
          "title": "Id"
        },
        "type": {
          "type": "string",
          "description": "The kind of message: `image`, `audio`, `video`, `document`, `sticker` and the like.",
          "title": "Type"
        },
        "mime_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The format of the file, or `null` if it is not known.",
          "title": "Mime Type"
        },
        "filename": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The name the file was sent with, when the channel gives one (documents usually do).",
          "title": "Filename"
        },
        "url": {
          "type": "string",
          "description": "The link to download the file with a plain `GET`, without your API key. Anyone who has it can download the file: do not share it or store it, ask for a new one when you need it.",
          "title": "Url"
        },
        "expires_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "When the link stops working (ISO 8601, 15 minutes after the request). `null` when the file is hosted by the channel itself: when that link stops working is up to the channel.",
          "title": "Expires At"
        }
      },
      "required": [
        "id",
        "type",
        "mime_type",
        "filename",
        "url",
        "expires_at"
      ],
      "description": "The file of one message and how to download it.",
      "title": "MessageMedia"
    }
  }
}