Skip to content

INTEGRATIONS · API

A streaming API.
Typed all the way down.

Every endpoint returns the same envelope — typed, versioned, and streamed over SSE so your UI paints as the answer forms. Watch it below.

  • BASEapi.aixys.dev/v1
  • TRANSPORTHTTP · SSE
  • AUTHbearer · OAuth
  • SPECOpenAPI 3.1

INTEGRATIONS · HTTP API

One typed API. Streaming by default.

Every endpoint returns the same envelope — typed, versioned, and streamed token-by-token so your UI can paint as the answer forms. Hover any key to see what it is.

REQUESTPOST/v1/events
{
  "subject_kind": "Deal",
  "subject_id":   "dl_9f2…",
  "verb":         "updated",
  "payload": {
    "stage": "negotiation",
    "amount": 184000
  }
}
RESPONSE200 · streaming

Hover any "key" in the response to read what it represents. In production the stream is Server-Sent Events; the shape is identical.

API · LIFE OF A REQUEST

From request to streamed response.

A request is authenticated, resolved to a tenant, typed against the graph, then streamed back. Every step is traced and stamped into the audit log.

EDGE

Request

HTTPS · HTTP/2

AUTH

Authenticate

bearer · scope

RESOLVE

Resolve tenant

policy engine

TYPE

Type-check

schema diff

STREAM

Stream

SSE · tokens

PROOF

Audit stamp

immutable

INTEGRATIONS · API ENVELOPES

One request envelope. One response envelope.

OBJECT

RequestEnvelope

Common shape every inbound HTTP request decodes into.

  • versionenumv1
  • tenant_iduuid
  • actorjsonUser | ServiceAccount
  • intentenumcreate | read | query | stream
  • payloadjsontyped against graph
  • trace_idulidpropagated end-to-end
OBJECT

ResponseEnvelope

Common shape every outbound HTTP response encodes to.

  • versionenumv1
  • statusnumber
  • shapeenumobject | list | stream
  • datajsontyped like its graph kind
  • fan_outjsonbus delivery summary
  • took_msnumber

PLATFORM · CLOSE THE LOOP

One API. Same shape. Whatever you ask.

Versioned, typed, streamed. Our reference spec is open. Our SDKs are thin. Our webhooks echo the exact same envelope.

Request sandbox accessBack to platform