Skip to content
/
List a sealed record's re...
Last updated

List a sealed record's revisions

The record's kept content history, newest first, without content: every create, update and undelete of the last 30 days, at most the newest 100 for the record and 1,000 across the store. Past the store's 1,000, its oldest revisions go first, whichever record they belong to.

A delete keeps no content, so its revision number does not appear. The history of a deleted record can be read too. Read one revision with its number to get its sealed payload.

GEThttps://api.aitronos.com/v1/sealed-stores/{store}/records/{record_id}/revisions

Path Parameters

store string required

The store: aitronos-browser. Up to 64 characters; an unknown store is 404 SEALED_STORE_NOT_FOUND.

record_id string required

The record's id, as the client minted it: 16 to 128 characters of A-Z a-z 0-9 _ -.

Headers

Authorization string required

Bearer <access token> from the person's own sign-in. API keys and service accounts are refused with 403 SEALED_STORE_PERSONAL_SESSION_REQUIRED.

Returns

200 OK:

  • object string — list.
  • data array — the kept revisions, newest first, without content:
    • object string — sealed_record_revision.
    • record_id string — the record's id.
    • revision integer — the revision number.
    • schema_version integer — as that write sent it.
    • device_id string — the device that wrote it.
    • written_at string — when it was written (ISO 8601 UTC).
    • payload_bytes integer — the decoded size of its payload.
  • has_more boolean — always false: the whole kept history is one page.
  • next_cursor null — always null.

Errors

StatusCodeWhen
401AUTHENTICATION_REQUIREDNo access token, or one that is not valid.
403SEALED_STORE_PERSONAL_SESSION_REQUIREDThe call used an API key or a service account. Only a person's own sign-in session reaches a sealed store.
404SEALED_STORE_NOT_FOUNDNo store with that name (details.store).
404SEALED_RECORD_NOT_FOUNDNo record with that id in the caller's store, or its tombstone has passed the 30-day retention.
422VALIDATION_ERRORrecord_id does not match its pattern.
cURL
curl "https://api.aitronos.com/v1/sealed-stores/aitronos-browser/records/vSWmWbg9sDur336pnYgYzQ/revisions" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response:

{
  "object": "list",
  "data": [
    {
      "object": "sealed_record_revision",
      "record_id": "vSWmWbg9sDur336pnYgYzQ",
      "revision": 4,
      "schema_version": 1,
      "device_id": "1aee2c02-ccac-4ede-b017-1334be895e2e",
      "written_at": "2026-10-10T10:12:31.660152Z",
      "payload_bytes": 112
    },
    {
      "object": "sealed_record_revision",
      "record_id": "vSWmWbg9sDur336pnYgYzQ",
      "revision": 2,
      "schema_version": 1,
      "device_id": "1aee2c02-ccac-4ede-b017-1334be895e2e",
      "written_at": "2026-10-10T09:02:44.918207Z",
      "payload_bytes": 112
    },
    {
      "object": "sealed_record_revision",
      "record_id": "vSWmWbg9sDur336pnYgYzQ",
      "revision": 1,
      "schema_version": 1,
      "device_id": "1f783def-2aa1-4b44-9c73-3c6b9102c06b",
      "written_at": "2026-10-10T08:41:17.204913Z",
      "payload_bytes": 96
    }
  ],
  "has_more": false,
  "next_cursor": null
}
Previous page
Next page