Records

Creating and updating

Writes are schema validated, size bounded, retry-safe where requested, and protected by optimistic concurrency.

Create from Go

payload := strings.NewReader(`{"values":{"title":"From Go"}}`)
req, _ := http.NewRequest("POST", base+"/api/v1/collections/issues/records", payload)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Idempotency-Key", "job-1042")
res, err := http.DefaultClient.Do(req)

Update from Python

requests.patch(
    f"{base}/api/v1/collections/issues/records/{record_id}",
    json={"values": {"status": "done"}},
    headers={"If-Match": '"3"'},
)

If-Match is mandatory for update and delete. A stale version returns 412 version_conflict; a missing version returns 428 precondition_required. A repeated create carrying the same idempotency key returns the original record with Idempotency-Replayed: true.