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

Request access

Asks the owner of a document you can't open for access, or, with role: "editor", for edit access to one you can read. The owner can approve or decline it.

API token required30 per hour per IPMCP: request_edit_access

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.

  • role"viewer" | "editor"

    viewer (the default) asks to open it; editor asks to edit a document you can already read. Default "viewer".

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.
Did this page help?