PUT/api/v1/documents/{slug}/access/level

Set who can open it

Sets a document's access level. Narrowing it takes effect at once, for every address the document has.

API token required60 per minute per IPMCP: set_access

Guide: Who can open a document

Code samples and Try it

Path parameters

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

Request body

application/json, required

level"private" | "link" | "workspace"Required
link (anyone with the link), private (only the people you share it with) or workspace (members of its workspace).

Responses

204No content.
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 PUT https://api.markdrop.in/api/v1/documents/k3x9q2m/access/level \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"level":"private"}'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m/access/level", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "level": "private"
  }),
});
if (!res.ok) throw new Error(`${res.status}`);

python

import os

import requests

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

Try it

API token

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

slugrequired

levelrequired

Your request

curl -X PUT https://api.markdrop.in/api/v1/documents/k3x9q2m/access/level \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"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?