Hanzo
OpenapiGraph

What is in force about an entity as of an instant, and what disagreed

What is in force about an entity as of an instant, and what disagreed

POST /v1/graph/resolve

Addresshttps://api.hanzo.ai/v1/graph/resolve
MethodPOST
OperationgraphResolve
AuthAuthorization: Bearer $HANZO_API_KEY

What is in force about an entity as of an instant, and what disagreed

Request

3 fields, body application/json (required).

FieldInTypeRequiredDescription
as_ofbodystringAsOf is the instant to answer at, RFC 3339.
entitybodystringEntity is the thing to answer about.
relationbodystringRelation is the one relation to settle.

Response

StatusBodyMeaning
200graphResolveOutok

200 body — 32 fields.

FieldInTypeAlwaysDescription
as_ofbodystringAsOf is the instant this answer was taken at, RFC 3339: the one asked for, or the server's clock when none was.
conflictsbodywireFact[]Conflicts is every OTHER assertion knowable at AsOf, strongest first.
conflicts[].atbodystringAt is when the thing was so, RFC 3339, as the asserter gave it.
conflicts[].bybodystringBy is the identity that filed it — owner or owner/user — stamped from the validated principal at the write, never from the body.
conflicts[].confidencebodynumberConfidence in [0,1] as the asserter gave it; absent is 0.
conflicts[].entitybodystringEntity is the thing described, in the organization's own namespace.
conflicts[].evidencebodystringEvidence points at the record the claim came from.
conflicts[].idbodystringID is the assertion's content address, minted by the server from what was asserted.
conflicts[].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.
conflicts[].namesbodybooleanNames true means the assertion is an edge and Value is an entity.
conflicts[].relationbodystringRelation is what was asserted of it.
conflicts[].seenbodystringSeen is when the asserter says it became knowable, RFC 3339.
conflicts[].sourcebodystringSource names who asserted, as the caller gave it.
conflicts[].valuebodystringValue is what the relation points at: another entity's key when Names is true, otherwise a scalar.
contestedbodybooleanContested is true when at least one conflict claims a value different from the winner's.
entitybodystringEntity is the entity the question named, echoed so a stored answer still says what it is about.
knownbodybooleanKnown is false when this plane held nothing knowable at AsOf.
relationbodystringRelation is the relation the question named, echoed for the same reason.
truncatedbodybooleanTruncated says this pair holds more assertions than one read returns, so the winner was decided from the most recent ceiling-full of them.
winnerbodywireFact
winner.atbodystringAt is when the thing was so, RFC 3339, as the asserter gave it.
winner.bybodystringBy is the identity that filed it — owner or owner/user — stamped from the validated principal at the write, never from the body.
winner.confidencebodynumberConfidence in [0,1] as the asserter gave it; absent is 0.
winner.entitybodystringEntity is the thing described, in the organization's own namespace.
winner.evidencebodystringEvidence points at the record the claim came from.
winner.idbodystringID is the assertion's content address, minted by the server from what was asserted.
winner.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.
winner.namesbodybooleanNames true means the assertion is an edge and Value is an entity.
winner.relationbodystringRelation is what was asserted of it.
winner.seenbodystringSeen is when the asserter says it became knowable, RFC 3339.
winner.sourcebodystringSource names who asserted, as the caller gave it.
winner.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