curl --request GET \
--url https://api.nohead.io/v1/drafts/{draft_id} \
--header 'Authorization: Bearer <token>'import { Nohead } from "@nohead/sdk"
const nohead = new Nohead()
const result = await nohead.drafts.get("drf_01J9ZQ3F8X", { expand: ["author"] })
from nohead import Nohead
nohead = Nohead()
result = nohead.drafts.get("drf_01J9ZQ3F8X", expand=["author"])
require "nohead"
nohead = Nohead::Client.new
result = nohead.drafts.get("drf_01J9ZQ3F8X", expand: ["author"])
{
"id": "drf_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"object": "draft",
"record_id": "<string>",
"collection_id": "<string>",
"collection": "<string>",
"base_revision": 123,
"revision": 123,
"data": {
"title": "Introducing Foo",
"body": {
"type": "doc",
"content": []
}
},
"changed_fields": [
"<string>"
],
"schedule": {
"merge_at": "2023-11-07T05:31:56Z",
"last_error": "<string>"
},
"created_by": {
"type": "user",
"id": "<string>",
"name": "<string>"
},
"edited_by": [
{
"type": "user",
"id": "<string>",
"name": "<string>"
}
],
"created_at": "2026-09-27T12:00:00.000Z",
"updated_at": "2026-09-27T12:00:00.000Z",
"expanded": {}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}Get a draft
The draft, with data as the record would read after the merge, so a
site’s preview route can render it; expand embeds what its relation
and asset fields point at, as for a record. 404 while the record is
deleted. Published-only API keys get 403.
curl --request GET \
--url https://api.nohead.io/v1/drafts/{draft_id} \
--header 'Authorization: Bearer <token>'import { Nohead } from "@nohead/sdk"
const nohead = new Nohead()
const result = await nohead.drafts.get("drf_01J9ZQ3F8X", { expand: ["author"] })
from nohead import Nohead
nohead = Nohead()
result = nohead.drafts.get("drf_01J9ZQ3F8X", expand=["author"])
require "nohead"
nohead = Nohead::Client.new
result = nohead.drafts.get("drf_01J9ZQ3F8X", expand: ["author"])
{
"id": "drf_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"object": "draft",
"record_id": "<string>",
"collection_id": "<string>",
"collection": "<string>",
"base_revision": 123,
"revision": 123,
"data": {
"title": "Introducing Foo",
"body": {
"type": "doc",
"content": []
}
},
"changed_fields": [
"<string>"
],
"schedule": {
"merge_at": "2023-11-07T05:31:56Z",
"last_error": "<string>"
},
"created_by": {
"type": "user",
"id": "<string>",
"name": "<string>"
},
"edited_by": [
{
"type": "user",
"id": "<string>",
"name": "<string>"
}
],
"created_at": "2026-09-27T12:00:00.000Z",
"updated_at": "2026-09-27T12:00:00.000Z",
"expanded": {}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}Authorizations
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
Query Parameters
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.
document, html, markdown Comma-separated relation, asset or rich text field keys whose records or assets to embed under expanded (at most 5); for a rich text field, the assets its images show. Embedding needs permission to read what is embedded: records:read for relations, assets:read for assets and rich text (403 otherwise).
Response
The draft.
Changes to a record's content that wait until they are merged into
it, now or at schedule.merge_at. Content only: whether the record
is live is its publication and schedule.
"drf_01J9ZQ3F8X5W2K7M4N6P0R1S2T"
The collection slug.
The record's revision when the draft started. Fields the record
changed since keep their values at the merge, unless the draft
changes them too; compare with GET /v1/records/{id}/diff?from=<base_revision>.
The draft's own revision, 1 when started and one more per change; also returned as the ETag.
The record's values as they read after the merge.
{ "title": "Introducing Foo", "body": { "type": "doc", "content": [] } }
Keys of the fields the draft changes.
When the draft merges on its own (within a minute of the time), set
with PUT /v1/drafts/{draft_id}/schedule. last_error explains the
last scheduled merge that could not be made, until a new one is set.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Everyone who changed it since, in order.
Show child attributes
Show child attributes
ISO 8601 timestamp in UTC.
"2026-09-27T12:00:00.000Z"
ISO 8601 timestamp in UTC.
"2026-09-27T12:00:00.000Z"
Only with expand, as on a record, for the values after the merge.
Show child attributes
Show child attributes