Hanzo
OpenapiGraph

Read the assertions this organization has recorded

Read the assertions this organization has recorded

GET /v1/graph

Addresshttps://api.hanzo.ai/v1/graph
MethodGET
OperationgraphRead
AuthAuthorization: Bearer $HANZO_API_KEY

Read the assertions this organization has recorded

Request

5 fields.

FieldInTypeRequiredDescription
entityquerystringEntity narrows to what was asserted ABOUT one entity.
relationquerystringRelation narrows to one relation.
valuequerystringValue narrows to assertions pointing AT one value, which is how the edges into an entity are read.
as_ofquerystringAsOf bounds the read to what was knowable at an instant, RFC 3339.
limitqueryintegerLimit caps how many assertions come back.

Response

StatusBodyMeaning
200graphReadOutok

200 body — 13 fields.

FieldInTypeAlwaysDescription
assertionsbodywireFact[]Assertions are the matching rows in the order they were written, oldest first.
assertions[].atbodystringAt is when the thing was so, RFC 3339, as the asserter gave it.
assertions[].bybodystringBy is the identity that filed it — owner or owner/user — stamped from the validated principal at the write, never from the body.
assertions[].confidencebodynumberConfidence in [0,1] as the asserter gave it; absent is 0.
assertions[].entitybodystringEntity is the thing described, in the organization's own namespace.
assertions[].evidencebodystringEvidence points at the record the claim came from.
assertions[].idbodystringID is the assertion's content address, minted by the server from what was asserted.
assertions[].knowablebodystringKnowable is the first instant this plane could have answered with the assertion, RFC 3339: the later of Seen and the server's clock at the write.
assertions[].namesbodybooleanNames true means the assertion is an edge and Value is an entity.
assertions[].relationbodystringRelation is what was asserted of it.
assertions[].seenbodystringSeen is when the asserter says it became knowable, RFC 3339.
assertions[].sourcebodystringSource names who asserted, as the caller gave it.
assertions[].valuebodystringValue is what the relation points at: another entity's key when Names is true, otherwise a scalar.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Graph API · All Hanzo APIs · Interactive reference

How is this guide?

On this page