Skip to main content

History APIs

History APIs

These endpoints enable querying of historical repository states by specifying a particular version (repoVersion). They support retrieval of partitions and nodes as they existed at a given point in time. These APIs follow the LionWeb Bulk API patterns and are primarily intended for analytical or auditing use.

Endpoints

POST /history/listPartitions

Returns all top-level (partition) nodes that existed at a given repository version. These are nodes without parents.

  • Query Parameters:

    • repoVersion (optional): The historical version to retrieve. If not specified, uses the latest (FOREVER).
  • Body: No body is required.

  • Returns: A list of partition node summaries.

POST /history/retrieve

Retrieves one or more nodes (and their contents) as they were at a specified historical version, up to a certain depth.

  • Body:

    {
    "ids": ["node-id-1", "node-id-2", "..."]
    }
  • Query Parameters:

    • depthLimit (optional): The level of nested parts to include. Defaults to the maximum possible.
    • repoVersion (optional): The repository version to retrieve. Defaults to the latest (FOREVER).
  • Returns: A nested structure of nodes, matching the version and depth specified.

Notes

  • These endpoints do not modify the repository in any way—they are read-only and safe for analytics and audits.