linkbreakers-com · Schema

Request to start a direct upload

QR CodesLead CaptureWebhookSDK

Properties

Name Type Description
fileName string
mimeType string The file's MIME type: image/png, image/jpeg, image/webp, image/svg+xml, application/pdf or video/mp4. The uploaded bytes must be this format.
sha256 string Optional: the file's SHA-256 digest, 64 hexadecimal characters. When given, a file the workspace already holds is refused at once with 409 MEDIA_ALREADY_EXISTS (metadata existingMediaId and existingFi
size integer The file's exact size in bytes. The PUT must send exactly this many bytes.
uploadedFrom object Where the media was uploaded from, so pickers can show a section's own uploads first. It does not limit where the media can be used; see references for where it is used. Unset means UPLOAD_ORIGIN_MEDI
usage object Deprecated: an upload no longer needs to say what the media is for, and this no longer limits the kinds or sizes accepted. Optional, accepted for compatibility and recorded as uploaded_from when uploa
visibility object The visibility of the media. If not provided, the media file will be private.
View JSON Schema on GitHub

JSON Schema

linkbreakers-com-create-media-upload-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/linkbreakers-com/json-schema/linkbreakers-com-create-media-upload-request-schema.json",
  "title": "Request to start a direct upload",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/linkbreakers-com-media-api-openapi.yml#/components/schemas/CreateMediaUploadRequest",
  "properties": {
    "fileName": {
      "title": "The name of the file, shown in the media library and as the file name visitors download",
      "type": "string"
    },
    "mimeType": {
      "description": "The file's MIME type: image/png, image/jpeg, image/webp, image/svg+xml, application/pdf or video/mp4. The uploaded bytes must be this format.",
      "type": "string"
    },
    "sha256": {
      "description": "Optional: the file's SHA-256 digest, 64 hexadecimal characters. When given, a file the workspace\nalready holds is refused at once with 409 MEDIA_ALREADY_EXISTS (metadata existingMediaId and\nexistingFileName), and storage refuses a PUT whose bytes do not match it, so the PUT must carry\nthe x-amz-checksum-sha256 header from upload_headers. When omitted, the server hashes the file on\ncompletion instead.",
      "type": "string"
    },
    "size": {
      "description": "The file's exact size in bytes. The PUT must send exactly this many bytes.",
      "format": "int64",
      "type": "integer"
    },
    "uploadedFrom": {
      "$ref": "#/$defs/MediaUploadOrigin",
      "description": "Where the media was uploaded from, so pickers can show a section's own uploads first. It does not\nlimit where the media can be used; see references for where it is used. Unset means\nUPLOAD_ORIGIN_MEDIA_LIBRARY."
    },
    "usage": {
      "$ref": "#/$defs/MediaUsage",
      "description": "Deprecated: an upload no longer needs to say what the media is for, and this no longer limits the\nkinds or sizes accepted. Optional, accepted for compatibility and recorded as uploaded_from when\nuploaded_from is not set."
    },
    "visibility": {
      "$ref": "#/$defs/MediaVisibility",
      "description": "The visibility of the media. If not provided, the media file will be private."
    }
  },
  "required": [
    "fileName",
    "mimeType",
    "size"
  ],
  "type": "object",
  "$defs": {
    "MediaUploadOrigin": {
      "default": "UPLOAD_ORIGIN_UNSPECIFIED",
      "description": "UploadOrigin is where in the product a media item was uploaded from. It is information only, so\npickers can show a section's own uploads first; it never limits where the media can be used.\nTo add a place, add a value here (next number), map it in core, and pass it from the screen that uploads.\n\n - UPLOAD_ORIGIN_UNSPECIFIED: Not set. Uploads that do not say where they come from are recorded as UPLOAD_ORIGIN_MEDIA_LIBRARY.\n - UPLOAD_ORIGIN_MEDIA_LIBRARY: Uploaded from the media library itself\n - UPLOAD_ORIGIN_QR_CODE_LOGO: Uploaded while picking a QR code's logo\n - UPLOAD_ORIGIN_BACKGROUND_COVER: Uploaded while picking a page theme's background cover\n - UPLOAD_ORIGIN_BADGE: Uploaded while picking a page theme's badge\n - UPLOAD_ORIGIN_FOOTER_LOGO: Uploaded while picking a page theme's footer logo\n - UPLOAD_ORIGIN_OPEN_MEDIA: Uploaded while picking the media an Open media step opens\n - UPLOAD_ORIGIN_ASSISTANT: Imported by the Assistant, from a file attached to a conversation or a URL",
      "enum": [
        "UPLOAD_ORIGIN_UNSPECIFIED",
        "UPLOAD_ORIGIN_MEDIA_LIBRARY",
        "UPLOAD_ORIGIN_QR_CODE_LOGO",
        "UPLOAD_ORIGIN_BACKGROUND_COVER",
        "UPLOAD_ORIGIN_BADGE",
        "UPLOAD_ORIGIN_FOOTER_LOGO",
        "UPLOAD_ORIGIN_OPEN_MEDIA",
        "UPLOAD_ORIGIN_ASSISTANT"
      ],
      "type": "string"
    },
    "MediaUsage": {
      "default": "USAGE_UNSPECIFIED",
      "description": "Deprecated: the value recorded at upload, kept for older clients. It no longer limits anything. Uploads\naccept images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB,\nwhatever the usage. Where media is used is checked when it is attached: a QR code logo, background\ncover, badge or footer logo must be an image of at most 3 MB; an Open media step takes any media.\n\n - USAGE_UNSPECIFIED: Not set\n - USAGE_CENTRAL_QRCODE_IMAGE: The logo in the center of a QR code\n - USAGE_BACKGROUND_COVER: A page theme's background cover\n - USAGE_BADGE: A page theme's badge image\n - USAGE_FOOTER_LOGO: A page theme's footer logo\n - USAGE_OPEN_MEDIA: Media an Open media workflow step hands to visitors: a PDF menu or brochure, an image or an MP4 video",
      "enum": [
        "USAGE_UNSPECIFIED",
        "USAGE_CENTRAL_QRCODE_IMAGE",
        "USAGE_BACKGROUND_COVER",
        "USAGE_BADGE",
        "USAGE_FOOTER_LOGO",
        "USAGE_OPEN_MEDIA"
      ],
      "type": "string"
    },
    "MediaVisibility": {
      "default": "VISIBILITY_UNSPECIFIED",
      "description": "- VISIBILITY_UNSPECIFIED: Media visibility not specified\nThe media visibility is not specified\n - VISIBILITY_PUBLIC: The media visibility is public\n - VISIBILITY_PRIVATE: The media visibility is private",
      "enum": [
        "VISIBILITY_UNSPECIFIED",
        "VISIBILITY_PUBLIC",
        "VISIBILITY_PRIVATE"
      ],
      "title": "Visibility represents the visibility of a media file",
      "type": "string"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/linkbreakers-com-create-media-upload-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.