Trace where a version came from
Returns the chain that produced one version of an object: the revision that wrote it, and beneath it the evidence and earlier edits it was derived from, each as a node with its own children.
GET /context/v1/context-history/{object_id}/lineage
Returns the chain that produced one version of an object: the revision that wrote it, and beneath it the evidence and earlier edits it was derived from, each as a node with its own children. Defaults to the latest version.
Requires the context:read scope.
Parameters
| Parameter | Location | Required | Description |
|---|---|---|---|
object_id | path | yes | The id of the context object. |
version | query | no | Which version to trace. Defaults to the latest. |
Responses
| Status | Meaning |
|---|---|
200 | The request succeeded. |
401 | The token is missing, expired or invalid. |
403 | The token does not carry the scope this operation requires. |
404 | No such project, or the token belongs to a different project. |
422 | The request was not valid: a parameter or the body failed validation. |
The 200 response body:
| Field | Type | Required | Description |
|---|---|---|---|
object_id | string | yes | The object's id. |
root | object | yes | The revision that made this version. Its children are what it was derived from, each with its own children, so the whole chain can be walked; every earlier version's own revision follows, newest first, so the lineage is cumulative. |
version | integer | yes | The version traced. |
Example
curl -sS "$API_URL/context/v1/context-history/$OBJECT_ID/lineage" \
-H "Authorization: Bearer $TOKEN"Get an object's revisions
Returns every revision of one context object, oldest to newest: the version each made, who wrote it, why, and from which sources.
List the sources behind an object
Returns every source an object's history cites, with the versions that cite each, and names the versions that cite none or only a lineage.