POST/api/v1/documents/access/level

Set access for several documents

Sets the access level of many documents you own at once. Each one is checked on its own: the response has a result per address.

API token required30 per minute per IP

Code samples and Try it

Request body

application/json, required

slugsarray of stringRequired
1–200 items.
level"private" | "link" | "workspace"Required

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/access/level \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"slugs":["k3x9q2m","q3-report"],"level":"private"}'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/documents/access/level", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slugs": [
      "k3x9q2m",
      "q3-report"
    ],
    "level": "private"
  }),
});
const data = await res.json();

python

import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/documents/access/level",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"slugs": ["k3x9q2m", "q3-report"], "level": "private"},
)
r.raise_for_status()
print(r.json())

Try it

API token

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

slugsrequired

levelrequired

Your request

curl -X POST https://api.markdrop.in/api/v1/documents/access/level \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"slugs":["k3x9q2m","q3-report"],"level":"private"}'

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?