POST/api/v1/files/{slug}/versions/{version}/restore

Restore a file version

Makes an earlier version current again, at the same link. Versions start at 1.

API token required30 per minute per IPMCP: restore_file_version CLI: markdrop restore

Guide: Replace and versions

Code samples and Try it

Path parameters

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

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: 15 fields (FileInfoResponse)

slugstring
urlstring
markdrop_urlstring | null
workspace_urlstring | null
titlestring | null
Shown on the page and in link previews.
content_typestring
size_bytesinteger
sha256string | null
versioninteger
updated_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
created_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
mediaobject | null
5 fields inside
- duration_snumber | null
- widthinteger | null
- heightinteger | null
- video_codecstring | null
- audio_codecstring | null
poster_urlstring | null
download_urlstring | null
accessstring

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

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