{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/htmlradar-com/json-schema/htmlradar-com-post-api-v1-shares-request-schema.json",
  "title": "PostApiV1SharesRequest",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/htmlradar-com-openapi-generated.yml#/components/schemas/PostApiV1SharesRequest",
  "type": "object",
  "properties": {
    "html": {
      "type": "string",
      "description": "Full markup. Up to 5 MB."
    },
    "url": {
      "type": "string",
      "description": "Accepted in the shape, but URL mode is not live on the API yet."
    },
    "document_id": {
      "type": "string",
      "description": "A second link on a document you already created."
    },
    "title": {
      "type": "string",
      "description": "The document's <title>"
    },
    "recipient_label": {
      "type": "string",
      "description": "Who the link is for."
    },
    "require_email": {
      "type": "boolean",
      "description": "Ask for an email before the document opens."
    },
    "verify_email": {
      "type": "boolean",
      "description": "Mails a six‑digit code to the address the reader types on the gate."
    },
    "password": {
      "type": "string",
      "description": "Extra gate on top of the email gate. At least 8 characters."
    },
    "allow_comments": {
      "type": "boolean",
      "description": "Whether readers can comment."
    },
    "lock_deck": {
      "type": "boolean",
      "description": "Blocks save and print."
    },
    "show_watermark": {
      "type": "boolean",
      "description": "Shows a faint watermark when lock_deck is true."
    },
    "allowed_email_domains": {
      "type": "array",
      "description": "Only these domains may open it."
    },
    "allowed_emails": {
      "type": "array",
      "description": "Only these exact addresses may open it."
    },
    "expires_in_hours": {
      "type": "number",
      "description": "The link stops working after it."
    },
    "slug": {
      "type": "string",
      "description": "Custom link name."
    },
    "domain_id": {
      "type": "string",
      "description": "Account default or custom domain."
    }
  }
}