POST/api/v1/trash/{slug}/restore

Restore from the trash

Puts a deleted item back where it was, with the same link, access and people, together with what was deleted with it: a page's sub-pages, or a folder's folders and items. If the place it came from is gone, it comes back as close as it can and notes says where. Send a token as its owner or an admin of its workspace, or the document's edit secret.

Token optionalOr edit secret10 per minute per IPMCP: restore_document

Guide: Trash

Code samples and Try it

Path parameters

slugstringRequired
The item's address, or a deleted folder's id, from List the trash.

Headers

X-Edit-Secretstring
The document's edit secret (sk_…), for a document published without an account. See Edit key.

Responses

200OK.
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/trash/k3x9q2m/restore \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

javascript

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

python

import os

import requests

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

Try it

API token (optional)

Leave it empty to send the request anonymously. Kept in this tab only, and sent only to the API. Create a token

slugrequired

X-Edit-Secret

Your request

curl -X POST https://api.markdrop.in/api/v1/trash/k3x9q2m/restore

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?