PUT/api/v1/documents/{slug}/editor

Switch the editor

Opens a document in the block editor (blocks) or the classic Markdown editor (classic). The Markdown doesn't change. Not for files or end-to-end encrypted documents.

Token optionalOr edit secret10 per minute per IP

Code samples and Try it

Path parameters

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

Headers

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

Request body

application/json, required

editor"blocks" | "classic"Required
blocks for the block editor, classic for the Markdown editor.

Responses

200OK.
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: 51 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.
revinteger | null
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.
presence_ticketstring | null
show_presenceboolean | null
editorstring | null
parentobject | null
breadcrumbsarray of object
children_countinteger
Default 0.
access_inheritboolean | null
page_patharray of string
template_idstring | null
templateobject | null
pageobject | null
page_propertiesobject | null
assetsobject
Default {}.
cover_autoboolean
Default false.
cover_pendingboolean
Default false.

const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m/editor", { method: "PUT", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "editor": "blocks" }), }); const data = await res.json();

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