Querying Facts

1 min readAgent developerSpec-03-HTTP-API

What this page is

Quick reference for the GET /v1/facts query API.

Coming soon

Full guide content is planned for the next docs sprint.

Quick example

# All facts for a specific entity
curl -s 'http://localhost:8000/v1/facts?entity=user:alice' \
  -H 'Authorization: Bearer dev-key' | jq .facts

# Filter by entity + relation
curl -s 'http://localhost:8000/v1/facts?entity=user:alice&relation=memory:prefers' \
  -H 'Authorization: Bearer dev-key' | jq '.facts[0].value'

# Only high-confidence facts
curl -s 'http://localhost:8000/v1/facts?min_confidence=0.8' \
  -H 'Authorization: Bearer dev-key' | jq .

Topics to be covered

Filtering

By entity, relation, source, scope (see Spec-03-HTTP-API query-facts route).

Pagination

Cursor-based via the cursor field.

Polling for new facts

With the after HLC cursor.

Including contradicted and expired facts

Scoped access

Local vs. company facts.

See the API Reference for the full GET /v1/facts endpoint spec.

Quick example​

Topics to be covered​