Meridian Docs

Documents

A document is the unit Meridian stores: a JSON body, a revision history, and metadata used for search and access control.

Create a document

POST /v1/documents
Content-Type: application/json

{
  "collection": "invoices",
  "body": { "number": "INV-2041", "total": 128400 },
  "meta": { "region": "eu-west" }
}

Response fields

fieldtypenotes
idstringstable identifier
revisionintegerincrements on every write
checksumstringSHA-256 of the canonical body

Writes are idempotent when an Idempotency-Key header is supplied. Retries within 24 hours return the original response.

List documents

GET /v1/documents?collection=invoices&limit=50&cursor=eyJvZmZzZXQiOjUwfQ

Cursors are opaque. Do not parse them; pass the value from next_cursor unchanged.