POST/api/v1/artifacts/paste

Publish an HTML page

Publishes HTML you send in the request as a page that renders. Up to 10 MB; anything larger goes through Start a file upload.

API token required10 per minute per IPMCP: publish_page

Guide: HTML pages

Code samples and Try it

Request body

application/json, required

contentstringRequired
The document's Markdown.
titlestring
Shown on the page and in link previews. Up to 200 characters.
custom_slugstring
Your own address: markdrop.in/<custom_slug>. Letters, digits, - and _. Taken or reserved addresses answer 409. 3–50 characters. Matches ^[a-zA-Z0-9_-]+$.
expires_in"never" | "1d" | "7d" | "30d" | "custom"
When the document is deleted. custom needs custom_expires_at. Default "never".
custom_expires_atstring (date-time)
The deletion time, when expires_in is custom. Must be in the future. ISO 8601, for example 2026-11-30T12:00:00Z.
read_passwordstring
Readers must enter this password before they see the content. 1–100 characters.
access_level"private" | "link"
Who can open it: link (anyone with the link), private (only you and the people you share it with) or workspace (members of its workspace). Default "link".

Responses

201Created.
401No token, or the token is revoked or mistyped.
413The HTML is over 10 MB.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.
507Your storage is full.

201 response: 22 fields (ArtifactCreateResponse)

slugstring
urlstring
titlestring | null
Shown on the page and in link previews.
kindstring
Default "artifact".
mimestring
rendererstring
type_labelstring
size_bytesinteger
original_filenamestring | null
artifact_urlstring
workspace_urlstring | null
download_urlstring
poster_urlstring | null
mediaobject | null
created_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
updated_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
expires_atstring (date-time) | null
ISO 8601, for example 2026-11-30T12:00:00Z.
viewsinteger
Default 0.
is_password_protectedboolean
Default false.
is_ownerboolean
Default false.
edit_secretstring
workspace_errorstring | null

curl -X POST https://api.markdrop.in/api/v1/artifacts/paste \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Launch page", "content": "<!doctype html><title>Launch</title><h1>Hello</h1>" }'

const res = await fetch("https://api.markdrop.in/api/v1/artifacts/paste", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "title": "Launch page", "content": "<!doctype html><title>Launch</title><h1>Hello</h1>" }), }); const data = await res.json();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/artifacts/paste", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={ "title": "Launch page", "content": "<!doctype html><title>Launch</title><h1>Hello</h1>", }, ) r.raise_for_status() print(r.json())