POST/api/v1/documents/{slug}/assets

Upload a page image

Uploads a PNG, JPEG, GIF or WebP image of up to 10 MB to a page, as multipart/form-data. Use the id it returns in the page as ![alt](asset:<id>). The image shows to exactly the page's readers.

Token optionalOr edit secret60 per minute per IPMCP: upload_page_image

Guide: Images in pages

Code samples and Try it

Path parameters

slugstringRequired
The document's address: the part after markdrop.in/.

Headers

X-Edit-Secretstring
The document's edit secret (sk_…), for a document published without an account. See Edit key.

Request body

multipart/form-data, required

filefileRequired

Responses

201Created.
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.

bash

curl -X POST https://api.markdrop.in/api/v1/documents/k3x9q2m/assets \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -F 'file=@logo.png'

javascript

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("logo.png")]), "logo.png");

const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m/assets", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
  },
  body: form,
});
const data = await res.json();

python

import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/documents/k3x9q2m/assets",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    files={"file": open("logo.png", "rb")},
)
r.raise_for_status()
print(r.json())

Try it

API token (optional)

Leave it empty to send the request anonymously. Kept in this tab only, and sent only to the API. Create a token

slugrequired

X-Edit-Secret

filerequired

Your request

curl -X POST https://api.markdrop.in/api/v1/documents/k3x9q2m/assets \
  -F 'file=@logo.png'

This calls the live API as you. Changes are real.

I understand, send real requests from this page

Tick the box above to send. Or copy the command and run it in a terminal.

Did this page help?