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

Resolve embedded items

What you may see of each Markdrop item embedded in a page you can read. Each item is checked with its own access: one you can't open comes back without its title, excerpt or link.

Token optionalOr edit secret60 per minute per IP

Guide: Embed and mention

Code samples and Try it

Path parameters

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

Headers

X-Read-Passwordstring
The password of a password-protected document.
X-Edit-Secretstring
The document's edit secret (sk_…), for a document published without an account. See Edit key.
X-Markdrop-Workspacestring
A workspace's id: answer only if the document is in that workspace, else 404. Workspace domains send it; you rarely need it.

Request body

application/json, required

slugsarray of stringRequired
Addresses of the embedded items, up to 100. Up to 100 items.

Responses

200OK.
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.

const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m/embeds", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "slugs": [ "k3x9q2m" ] }), }); const data = await res.json();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/documents/k3x9q2m/embeds", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={"slugs": ["k3x9q2m"]}, ) r.raise_for_status() print(r.json())