Skip to main content
  • Send Authorization: Bearer and a fresh Idempotency-Key on every request.
  • Treat entity_ref, property_ref, relationship_ref and source_refs as opaque strings; test for property_ref rather than a prefix.
  • Read status before data; handle partial per item via outcome.
  • Paginate with meta.next_cursor and the same request parameters; restart on 409 cursor_generation_changed.
  • Retry only when error.retryable is true, after retry_after_seconds when present.
  • Request only the property sections you need; a section with has_more: true cannot be continued, only widened with section_limit.
  • Keep source_refs with every fact you display and offer get_evidence as the way to verify it.