DELETE/api/v1/documents/{slug}

Delete a document

Deletes a document for good. Send a token as the owner, or the document's edit secret in X-Edit-Secret.

Token optionalOr edit secret10 per minute per IPMCP: delete_document

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.

Responses

204No content.
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 DELETE https://api.markdrop.in/api/v1/documents/k3x9q2m \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

javascript

const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status}`);

python

import os

import requests

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

Try it

API token (optional)

Kept in this tab only. Without one, the command reads $MARKDROP_TOKEN. Create a token

slugrequired

X-Edit-Secret

Your request

curl -X DELETE https://api.markdrop.in/api/v1/documents/k3x9q2m \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

The API accepts browser requests only from markdrop.in, so this page can’t send it for you. Run the command in a terminal.

Did this page help?