latestOpenAPI 3.0.02026-08-12131326.8 KB
2bd8b7cd3078
Trees
Get Pending Tree
Fetch a PENDING (staged, not-yet-on-chain) tree by its root hash.
A root is "pending" for a principal when it exists on one of their accessible vaults' protocol records but is not that vault's active on-chain root. Once the root is rotated on-chain it is no longer pending — this endpoint 404s for it and the base /trees/{root_hash} endpoint serves it instead.
Not cached (unlike the base endpoint): pending status is mutable — a root graduates on-chain (or is abandoned), which flips this endpoint's result — so the default no-store applies. The tree blob itself is content-addressed and immutable, but its accessibility here is not.
get/trees/{root_hash}/pending
Path parameters
root_hashstring required
Response
Successful Response
object required