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
| field | type | notes |
|---|---|---|
| id | string | stable identifier |
| revision | integer | increments on every write |
| checksum | string | SHA-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.