DELETE/api/v1/files/{slug}/versions/{version}

Delete a file version

Deletes one earlier version for good and frees its space. Only the file's owner can do this, and never for the current version.

API token required30 per minute per IP

Guide: Replace and versions

Code samples and Try it

Path parameters

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

Responses

204Deleted.
401No token, or the token is revoked or mistyped.
403You can edit the file but don't own it.
404That version isn't kept.
409That's the current version. Restore another one first, or delete the file.
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/files/k3x9q2m/versions/1 \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

javascript

const res = await fetch("https://api.markdrop.in/api/v1/files/k3x9q2m/versions/1", {
  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/files/k3x9q2m/versions/1",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
)
r.raise_for_status()

Try it

API token

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

slugrequired

versionrequired

Your request

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

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?