MintPage

Publish a new web page and get its public URL. Content is Markdown (GFM: tables, task lists, code fences) or HTML (sanitized: no scripts, forms or iframes; inline styles and <style> allowed). Returns the URL to show the user. Pages are public to anyone with the link. Publish only content the user asked for; to test the connection, call get_account instead of publishing.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Page title (also the browser tab title)."
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "description": "The page body in Markdown or HTML."
    },
    "format": {
      "type": "string",
      "enum": [
        "markdown",
        "html"
      ],
      "default": "markdown",
      "description": "How to interpret `content`."
    },
    "theme": {
      "type": "string",
      "enum": [
        "paper",
        "ink",
        "terminal"
      ],
      "default": "paper",
      "description": "Visual theme: paper (light), ink (dark), terminal (dark monospace)."
    },
    "byline": {
      "type": "string",
      "maxLength": 120,
      "description": "Shown above the page, e.g. 'Prepared by Claude for Alex'."
    },
    "slug": {
      "type": "string",
      "maxLength": 63,
      "description": "Custom URL slug (Pro only). Lowercase letters, digits, hyphens."
    },
    "expires_in_hours": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 8760
        },
        {
          "type": "null"
        }
      ],
      "description": "Hours until the page expires. Omit for the plan default (guest 24h, free 7 days, Pro never). Pro can pass null for never."
    }
  },
  "required": [
    "title",
    "content"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Replace the title, content, theme, byline, slug or expiry of a page you own. Omitted fields are kept. A new slug (Pro, or a minted page) changes the URL: the old link then shows 'revoked' and can't be reused. Minted pages stay permanent (expires_in_hours is ignored). Requires an API key (guest pages can't be edited).

{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "string",
      "format": "uuid",
      "description": "The page_id returned by publish_page or list_pages."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "content": {
      "type": "string",
      "minLength": 1
    },
    "format": {
      "type": "string",
      "enum": [
        "markdown",
        "html"
      ]
    },
    "theme": {
      "type": "string",
      "enum": [
        "paper",
        "ink",
        "terminal"
      ]
    },
    "byline": {
      "type": "string",
      "maxLength": 120
    },
    "slug": {
      "type": "string",
      "maxLength": 63,
      "description": "New custom URL slug (Pro or minted pages). Lowercase letters, digits, hyphens."
    },
    "expires_in_hours": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 8760
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "page_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Make one page permanent with one mint: it never expires, loses the MintPage badge, gets Pro limits (2 MB, custom slug via update_page, indexable) and stops counting toward the live-page limit. Costs 1 mint from the account's balance, once per page; no charge if the page is already minted or the account is on Pro (already permanent). Mints come in a Peppermint pack (10 for $5, one-time, never expire) at https://mintpage.ai/billing. It spends a paid credit, so only call it when the user asked for the page to stay up. Requires an API key.

{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "string",
      "format": "uuid",
      "description": "The page_id returned by publish_page or list_pages."
    }
  },
  "required": [
    "page_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the pages in this account (newest first) with URLs, view counts and expiry. Requires an API key.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Permanently take a page offline. The URL will show 'This page was removed'. Irreversible — confirm with the user first. Requires an API key.

{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "page_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Temporarily hide a page (paused: true) or bring it back (paused: false). While paused, the URL shows 'This page is paused' to everyone except the signed-in owner; nothing is deleted and the URL doesn't change. Requires an API key.

{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "string",
      "format": "uuid"
    },
    "paused": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "page_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn off a page's current link and give it a new random one, e.g. when the link reached the wrong people. The old URL shows 'This link was revoked' forever; content, stats and page_id are kept. Share the new url only with the right people. Requires an API key.

{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "page_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

View count, last viewed time and a 30-day daily breakdown for a page you own. Requires an API key.

{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "page_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Show the current plan, usage against limits, and where to upgrade or get a key. Works for guests too.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}