markdropDocs
Open Markdrop
GET/api/v1/documents/{slug}

Read a document

Returns a document's content and details, if you may read it. For a private or workspace document, send a token; for a password-protected one, send the password in X-Read-Password.

A document whose address changed answers at its old address too, but only to someone who can read it: 200 with "moved": true and the current slug.

Token optionalOr edit secret60 per minute per IPMCP: get_document
Code samples and Try it

Path parameters

#
  • slugstringRequired

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

Headers

#
  • X-Read-Passwordstring

    The password of a password-protected document.

  • X-Edit-Secretstring

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

  • X-Markdrop-Workspacestring
  • X-Markdrop-Pathstring

Responses

#
  • 200OK.
  • 401It needs a token, or the right password.
  • 404No such document, or you can't open it.
  • 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.
200 response: 35 fields (DocumentResponse)
  • slugstring

    The address: markdrop.in/<slug>.

  • urlstring

    The link to share.

  • folder_patharray of string
  • titlestring | null

    Shown on the page and in link previews.

  • contentstring

    The document's Markdown.

  • created_atstring (date-time)

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • updated_atstring (date-time)

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • expires_atstring (date-time) | null

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • viewsinteger

    Default 0.

  • is_password_protectedboolean

    Default false.

  • is_ownedboolean

    Default false.

  • is_ownerboolean

    Default false.

  • idstring | null
  • refstring | null
  • google_doc_urlstring | null
  • google_doc_staleboolean

    Default false.

  • vscode_syncedboolean

    Default false.

  • encryptedboolean

    Set by clients that encrypt in the browser: content and title are already ciphertext. The server never sees the key. Default false.

  • kindstring

    markdown for a document, artifact for a file. Default "markdown".

  • mimestring | null
  • rendererstring | null
  • type_labelstring | null
  • size_bytesinteger | null
  • original_filenamestring | null
  • artifact_urlstring | null
  • download_urlstring | null
  • poster_urlstring | null
  • mediaobject | null
  • file_versioninteger | null
  • workspace_urlstring | null

    The address on its workspace's own domain, when it has a live one.

  • access_levelstring

    Who can open it: link (anyone with the link), private (only you and the people you share it with) or workspace (members of its workspace). Default "link".

  • workspace_idstring | null
  • canobject | null

    What you may do with it: edit, replace, settings, access, rename, delete, share, move, unshare.

  • read_ticketstring | null
  • access_epochinteger

    Default 0.

Did this page help?