GET/api/v1/files/{slug}/versions

List file versions

Every version of a file you own. Replacing a file keeps the previous version.

API token required120 per minute per IPMCP: list_file_versions CLI: markdrop versions

Guide: Replace and versions

Code samples and Try it

Path parameters

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

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.

200 response: 1 field (FileVersionsResponse)

versionsarray of object
8 fields inside
- versioninteger
- size_bytesinteger
- sha256string | null
- content_typestring
- created_atstring (date-time) | null
  ISO 8601, for example 2026-11-30T12:00:00Z.
- currentboolean
- mediaobject | null
- filenamestring | null

bash

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

javascript

const res = await fetch("https://api.markdrop.in/api/v1/files/k3x9q2m/versions", {
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
  },
});
const data = await res.json();

python

import os

import requests

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

bash

markdrop versions k3x9q2m

Try it

API token

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

slugrequired

Your request

curl https://api.markdrop.in/api/v1/files/k3x9q2m/versions \
  -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?