Barkpark
API
Document envelope
Error codes
Known limitations
List documents
Filter operators
Get single document
Expand references
Search
create
createOrReplace
createIfNotExists
patch
publish
unpublish
discardDraft
delete
Export dataset
List revisions
Get revision
Restore revision
Dataset stats
SSE listen
List schemas
Show schema
List webhooks
Create webhook
Delete webhook
Document envelope

Every document is returned as a flat JSON object. Reserved keys are always present; user content adds additional flat fields. User content cannot override reserved keys — they are silently dropped on write.

Reserved keys
KeyTypeDescription
_idstringFull document id, including drafts. prefix when a draft
_typestringDocument type (matches schema name)
_revstring32-char hex; changes on every write
_draftbooleantrue when _id starts with drafts.
_publishedIdstringId with drafts. prefix stripped
_createdAtstringISO 8601 UTC, Z suffix
_updatedAtstringISO 8601 UTC, Z suffix
Example
{
  "_id": "p1",
  "_type": "post",
  "_rev": "a3f8c2d1e9b04567f2a1c3e5d7890abc",
  "_draft": false,
  "_publishedId": "p1",
  "_createdAt": "2026-04-12T09:11:20Z",
  "_updatedAt": "2026-04-12T10:03:45Z",
  "title": "Hello World",
  "category": "Tech"
}
Response
No response yet. Click Run.