markdropDocs
Open Markdrop
POST/api/v1/documents/{slug}/copy

Copy a document

Makes a copy of a document you can read, owned by you, with a new address, no password and no expiry. The copy is private unless the original is open to anyone with the link.

API token required10 per minute per IP
Code samples and Try it

Path parameters

#
  • slugstringRequired

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

Headers

#
  • X-Markdrop-Workspacestring

Request body

#

application/json, required

  • read_passwordstring

    Readers must enter this password before they see the content. Up to 100 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.
201 response: 37 fields (DocumentCreateResponse)
  • slugstring
  • urlstring
  • 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

    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
  • 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
  • read_ticketstring | null
  • access_epochinteger

    Default 0.

  • edit_secretstring

    Returned once. Send it as X-Edit-Secret to change or delete a document published without a token.

  • workspace_errorstring | null
Did this page help?