POST/api/v1/documents/{slug}/access-requests

Request access

Asks the owner of a document you can't open for access. The owner can approve or decline it.

API token required30 per hour per IP

Guide: Request access

Code samples and Try it

Path parameters

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

Request body

application/json, required

messagestring
Up to 500 characters.

Responses

201Created.
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/k3x9q2m/access-requests \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"Could I see the Q3 numbers?"}'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m/access-requests", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "message": "Could I see the Q3 numbers?"
  }),
});
const data = await res.json();

python

import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/documents/k3x9q2m/access-requests",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"message": "Could I see the Q3 numbers?"},
)
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

slugrequired

message

Your request

curl -X POST https://api.markdrop.in/api/v1/documents/k3x9q2m/access-requests \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"Could I see the Q3 numbers?"}'

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?