POST/api/v1/documents/{slug}/lock/keep

Keep unsaved text

Keeps text you couldn't save, because someone took over the page, as a version in its history. The page itself doesn't change.

API token required60 per minute per IP

Guide: Editing together

Code samples and Try it

Path parameters

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

Request body

application/json, required

titlestring
Shown on the page and in link previews. Up to 500 characters.
contentstringRequired
The document's Markdown. Up to 2,000,000 characters.
base_revinteger
reason"taken_over" | "lost" | "conflict"
Default "taken_over".

Responses

200OK.
401No token, or the token is revoked or mistyped.
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/lock/keep \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
       "title": "Launch plan",
       "content": "# Launch plan\n\nWhat I was writing…",
       "base_rev": 12,
       "reason": "taken_over"
     }'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m/lock/keep", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "title": "Launch plan",
    "content": "# Launch plan\n\nWhat I was writing…",
    "base_rev": 12,
    "reason": "taken_over"
  }),
});
const data = await res.json();

python

import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/documents/k3x9q2m/lock/keep",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={
        "title": "Launch plan",
        "content": "# Launch plan\n\nWhat I was writing…",
        "base_rev": 12,
        "reason": "taken_over",
    },
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only, and sent only to the API. Create a token

slugrequired

title

contentrequired

base_rev

reason

Your request

curl -X POST https://api.markdrop.in/api/v1/documents/k3x9q2m/lock/keep \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
       "title": "Launch plan",
       "content": "# Launch plan\n\nWhat I was writing…",
       "base_rev": 12,
       "reason": "taken_over"
     }'

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?