artidrop

Publish HTML or Markdown content as a shareable URL. Pass `content` byte-for-byte from the source — do not retype, reformat, minify, summarize, or 'clean up' the input; even one stray character can break inline scripts on the published page. If the content is too large to copy verbatim through the model, use the REST endpoint `POST /v1/artifacts` (or `/v1/artifacts/upload` for ZIPs) instead. For Markdown, optionally include images as base64-encoded data.

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The HTML or Markdown content to publish. Copy this verbatim from the source file or buffer — do not modify, reformat, or regenerate it. Whitespace, emojis, comments, and exact character sequences inside <script> and <style> blocks all matter. If you cannot fit the full content unmodified in one tool call, fall back to POST /v1/artifacts via curl."
    },
    "format": {
      "type": "string",
      "enum": [
        "html",
        "markdown"
      ],
      "description": "Content format"
    },
    "title": {
      "description": "Artifact title (default: Untitled)",
      "type": "string"
    },
    "visibility": {
      "description": "Visibility (default: unlisted)",
      "type": "string",
      "enum": [
        "public",
        "unlisted"
      ]
    },
    "images": {
      "description": "Images referenced in the markdown content. Only used when format is 'markdown'.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "Relative path as referenced in the markdown (e.g., 'images/demo.png')"
          },
          "data": {
            "type": "string",
            "description": "Base64-encoded image file data"
          }
        },
        "required": [
          "path",
          "data"
        ]
      }
    }
  },
  "required": [
    "content",
    "format"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Publish a multi-file HTML site from a base64-encoded ZIP file. The ZIP must contain an index.html at its root. For sites larger than ~10MB — or whenever you have the file on disk — prefer the REST API /v1/artifacts/upload endpoint to avoid base64 overhead and to guarantee byte-faithful upload.

{
  "type": "object",
  "properties": {
    "zip_base64": {
      "type": "string",
      "description": "Base64-encoded ZIP file containing the site files"
    },
    "title": {
      "description": "Site title (default: Untitled)",
      "type": "string"
    },
    "visibility": {
      "description": "Visibility (default: unlisted)",
      "type": "string",
      "enum": [
        "public",
        "unlisted"
      ]
    }
  },
  "required": [
    "zip_base64"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get artifact metadata. Set include_content to true to also return the full HTML content.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Artifact ID or short ID"
    },
    "include_content": {
      "description": "Include the full HTML content in the response (default: false)",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List version history of an artifact

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Artifact ID"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}