Grava Docs

Read ordered row and cell history

GET/v1/datasets/{datasetId}/changes

Read changes in ascending sequence. Keep the returned through value for subsequent pages; pass nextAfter as after. After draining the page, use through as after for the next poll and omit through. Optional rowId and fieldId select a row or cell timeline.

AuthorizationBearer <token>

API key shown once at creation and stored as a SHA-256 hash.

In: header

Path Parameters

datasetId*string

Dataset UUID.

Formatuuid

Query Parameters

after?integer
Range0 <= value
through?integer
Range0 <= value
limit?integer
Range1 <= value <= 100
Default50
rowId?string
Formatuuid
fieldId?string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/datasets/497f6eca-6276-4993-bfeb-53cbbbba6f08/changes"
{  "observations": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "datasetId": "6586f21b-ad4d-4d06-a309-712af47184a2",      "runId": "78c33d18-170c-44d3-a227-b3194f134f73",      "localId": "string",      "sourceKey": "string",      "scopeKey": "string",      "pageKey": "string",      "sourceUrl": "http://example.com",      "observedAt": "2019-08-24T14:15:22Z",      "contentDigest": "string",      "method": "deterministic",      "entries": [        {          "id": "string",          "excerpt": "string",          "truncated": true        }      ]    }  ],  "through": 0,  "nextAfter": 0,  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "datasetId": "6586f21b-ad4d-4d06-a309-712af47184a2",      "rowId": "c4e73cac-8b0c-4e55-94d1-531330067e81",      "sequence": 0,      "schemaVersion": 0,      "previousRevisionId": "eb2ae675-8d88-4cab-8282-b371b2c9411d",      "runId": "78c33d18-170c-44d3-a227-b3194f134f73",      "actorId": "d2f1b55c-8cee-4a0d-af57-aebaeff77518",      "requestId": "string",      "requestHash": "string",      "origin": "collection",      "kind": "created",      "changedFieldIds": [        "7950e59e-bcca-4e79-b31e-2077d2504dd7"      ],      "data": {        "property1": "string",        "property2": "string"      },      "evidence": {        "property1": [          {            "observationId": "75ba143a-548d-4455-94a8-6b10f7615329",            "entryId": "string"          }        ],        "property2": [          {            "observationId": "75ba143a-548d-4455-94a8-6b10f7615329",            "entryId": "string"          }        ]      },      "overrides": {        "property1": {          "value": "string",          "evidence": [            {              "observationId": "75ba143a-548d-4455-94a8-6b10f7615329",              "entryId": "string"            }          ],          "missingReason": "unknown"        },        "property2": {          "value": "string",          "evidence": [            {              "observationId": "75ba143a-548d-4455-94a8-6b10f7615329",              "entryId": "string"            }          ],          "missingReason": "unknown"        }      },      "missingReasons": {        "property1": "unknown",        "property2": "unknown"      },      "presence": "present",      "createdAt": "2019-08-24T14:15:22Z",      "beforeOverrides": {        "property1": {          "value": "string",          "evidence": [            {              "observationId": "75ba143a-548d-4455-94a8-6b10f7615329",              "entryId": "string"            }          ],          "missingReason": "unknown"        },        "property2": {          "value": "string",          "evidence": [            {              "observationId": "75ba143a-548d-4455-94a8-6b10f7615329",              "entryId": "string"            }          ],          "missingReason": "unknown"        }      },      "before": {        "property1": "string",        "property2": "string"      }    }  ],  "schemas": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "datasetId": "6586f21b-ad4d-4d06-a309-712af47184a2",      "version": 0,      "fields": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "label": "string",          "ownership": "collected",          "name": "string",          "type": "string",          "key": false,          "description": "string"        }      ],      "createdAt": "2019-08-24T14:15:22Z"    }  ]}