Search graph

GET /v1/graph/search

Graph → · All API references → · Get started →


Address	`https://api.hanzo.ai/v1/graph/search`
Method	`GET`
Operation	`graphSearch`
Auth	`Authorization: Bearer $HANZO_API_KEY`

Finds assertions by their text where read finds them by their keys.

It is the READ with one more term, not a second way to leave the store: same order, same ceiling, same tenancy, and searching composes with narrowing by relation and by instant because all of them are terms of one filter.

It resolves nothing. What matches is what was asserted, including claims that were later corrected — which is the honest answer to "where is this mentioned" and the reason the caller then asks resolve about what it found.

Request

4 fields.

Field	In	Type	Required	Description
`q`	query	string	—	Q is what to look for: words, matched as prefixes, all of them required.
`relation`	query	string	—	Relation narrows to one relation.
`as_of`	query	string	—	AsOf bounds the search to what was knowable at an instant, RFC 3339.
`limit`	query	integer	—	Limit caps how many assertions come back.

Response

Status	Body	Meaning
`200`	graphReadOut	ok

200 body — 13 fields.

Field	In	Type	Always	Description
`assertions`	body	wireFact[]	—	Assertions are the matching rows in the order they were written, oldest first.
`assertions[].at`	body	string	—	At is when the thing was so, RFC 3339, as the asserter gave it.
`assertions[].by`	body	string	—	By is the identity that filed it — `owner` or `owner/user` — stamped from the validated principal at the write, never from the body.
`assertions[].confidence`	body	number	—	Confidence in [0,1] as the asserter gave it; absent is 0.
`assertions[].entity`	body	string	—	Entity is the thing described, in the organization's own namespace.
`assertions[].evidence`	body	string	—	Evidence points at the record the claim came from.
`assertions[].id`	body	string	—	ID is the assertion's content address, minted by the server from what was asserted.
`assertions[].knowable`	body	string	—	Knowable 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[].names`	body	boolean	—	Names true means the assertion is an edge and Value is an entity.
`assertions[].relation`	body	string	—	Relation is what was asserted of it.
`assertions[].seen`	body	string	—	Seen is when the asserter says it became knowable, RFC 3339.
`assertions[].source`	body	string	—	Source names who asserted, as the caller gave it.
`assertions[].value`	body	string	—	Value 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 graph search

import { Configuration, GraphApi } from 'hanzoai';

const api = new GraphApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.graphSearch();

from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import GraphApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = GraphApi(client).graph_search()

cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)

resp, _, err := client.GraphAPI.GraphSearch(context.Background()).Execute()
if err != nil {
	return err
}

use hanzo_cloud::apis::{configuration::Configuration, graph_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = graph_api::graph_search(&cfg, Default::default()).await?;

import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.GraphApi;

ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));

var result = new GraphApi(client).graphSearch();

curl https://api.hanzo.ai/v1/graph/search \
  -H "Authorization: Bearer $HANZO_API_KEY"

MCP declares no tool for graph — tools/list on https://api.hanzo.ai/v1/mcp names the products it does reach. Use HTTP or an SDK.

Graph API · All Hanzo APIs · Interactive reference

Request

Response

Examples

On this page