POST/api/v1/ai/pages/notes

Draft a page from notes

Turns rough notes into a page in Markdown. 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 is saved: create the page with Create a page.

API token required30 per minute per IP

Guide: AI in pages

Code samples and Try it

Request body

application/json, required

notesstringRequired
The rough notes. Up to 42,000 characters.
templatestring
A built-in template's id to shape the page, or auto to let AI choose. Up to 64 characters.
titlestring
A title for the page. Up to 200 characters.
workspacestring
The workspace the page will go in (members and up). Its AI setting and limits apply. Up to 64 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/notes \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{"notes":"kickoff thurs, sam owns api, ship by 20th","template":"auto"}'

const res = await fetch("https://api.markdrop.in/api/v1/ai/pages/notes", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "notes": "kickoff thurs, sam owns api, ship by 20th", "template": "auto" }), }); const data = await res.text();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/ai/pages/notes", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={ "notes": "kickoff thurs, sam owns api, ship by 20th", "template": "auto", }, ) r.raise_for_status() print(r.text)