Skip to main content
The HelloNear backend API is described by an OpenAPI 3 spec, kept in the repository at docs/openapi.json and rendered from it in the Endpoints tab of this site, where each route has a playground that can call the hosted API. The prose contract, with every field and event, is docs/api-contract.md.
  • Server: https://api.hellonear.xyz (NEAR testnet), or http://localhost:4000 when you run it locally.
  • Auth: every route except health, status and auth needs the session cookie hn_session. Get one as a guest with POST /v1/auth/demo, or sign in with a NEAR wallet (NEP-413).
  • Errors: { error, ...details } with an HTTP status. See Errors.
  • Streams: chat, approval and workflow runs answer with server-sent events. See Streaming events.
A worked example with curl is in the Quickstart, and every route in a table is in the API overview.