POST/api/v1/ai/pages/{slug}/transform

Rewrite a selection

Rewrites text from a page you can edit: improves, shortens or fixes it, changes its tone, translates it, or turns it into a checklist, a table or an explanation. Streams the result as server-sent events: delta events with text as it's written, then done (or limit when a limit stops it). Nothing changes on the page: the result is a suggestion.

API token requiredOr edit secret60 per minute per IP

Guide: AI in pages

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

actionstringRequired
improve, shorten, fix, tone, translate, checklist, table or explain. Up to 20 characters.
textstringRequired
The selected text. Up to 14,000 characters.
tonestring
For tone: professional, friendly or concise. Up to 20 characters.
langstring
For translate: the language, in English, like Spanish. Up to 40 characters.
beforestring
Text just before the selection, for context. Up to 2,000 characters.
afterstring
Text just after the selection, for context. Up to 2,000 characters.

Responses

200OK.
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.

curl -X POST https://api.markdrop.in/api/v1/ai/pages/k3x9q2m/transform \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "action": "shorten", "text": "We are going to be shipping the new release at some point next week." }'

const res = await fetch("https://api.markdrop.in/api/v1/ai/pages/k3x9q2m/transform", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "action": "shorten", "text": "We are going to be shipping the new release at some point next week." }), }); const data = await res.text();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/ai/pages/k3x9q2m/transform", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={ "action": "shorten", "text": "We are going to be shipping the new release at some point next week.", }, ) r.raise_for_status() print(r.text)