Hanzo
OpenapiGraph

Assert what is true of an entity

Assert what is true of an entity

POST /v1/graph

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

Assert what is true of an entity

Request

10 fields, body application/json (required).

FieldInTypeRequiredDescription
assertionsbodygraphFact[]Assertions is the batch. Each member is judged on its own: one refusal does not discard the rest, because a caller redelivering five facts must not lose four…
assertions[].atbodystringAt is when the thing was so, RFC 3339. Required, and refused when it sits more than five minutes ahead of the server clock — an assertion dated further out…
assertions[].confidencebodynumberConfidence in [0,1].
assertions[].entitybodystringEntity is the thing being described, in the organization's own namespace. It is not created: an entity exists because something was asserted about it.
assertions[].evidencebodystringEvidence points at the record this claim came from, 512 bytes at most.
assertions[].namesbodybooleanNames says the value is an entity.
assertions[].relationbodystringRelation is what is being asserted — depends, owner, same, title.
assertions[].seenbodystringSeen is when this assertion became knowable, RFC 3339. Defaults to At and may not precede it.
assertions[].sourcebodystringSource names who asserted. Required, because an assertion nobody is named for cannot be weighed against one that is.
assertions[].valuebodystringValue is what the relation points at. When Names is true it is another entity's key and the assertion is an EDGE; otherwise it is a scalar and the assertion is…

Response

StatusBodyMeaning
200graphAssertOutok

200 body — 4 fields.

FieldInTypeAlwaysDescription
duplicatebodyintegerDuplicate is how many members this plane already held.
reasonsbodystring[]Reasons names why each refused member was refused, in the order sent.
recordedbodyintegerRecorded is how many members became new rows.
refusedbodyintegerRefused is how many members were turned away at the door, before the store was touched — a missing entity, a timestamp that is not RFC 3339, a confidence…

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