Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Project-scoped API key, e.g. nohead_sk_k7fz0a9c3m2q_<secret>, or nohead_pk_… for a published-only key. Used by servers, CI, the CLI and coding agents.

Path Parameters

collection_id
string
required

Collection ID, or the collection slug when authenticating with an API key.

Query Parameters

rich_text
enum<string>
default:document

How rich text fields read in the records and drafts returned (and in records they embed with expand): document, the stored ProseMirror JSON document; html, an HTML fragment of known elements with every text and attribute escaped, to put in a page as it is; or markdown (GitHub Flavored), which reads back as the same document when written. Images render with their URLs, so they need no expand: in HTML a WebP rendition at most 1600 pixels wide with its width and height (an SVG as itself), in Markdown the asset's image_url. An image whose asset was deleted is left out of HTML, and written as its asset ID in Markdown. Record history keeps documents.

Available options:
document,
html,
markdown
sort
enum<string>
default:-updated_at
Available options:
updated_at,
-updated_at
limit
integer
default:20

Page size.

Required range: 1 <= x <= 100
cursor
string

The next_cursor from the previous page.

Response

A page of drafts.

data
object[]
required
meta
object
required

Cursor pagination metadata returned with every list.