API ReferenceSSF

Poll & Acknowledge Events

For poll-mode SSF streams -- pull pending events, then acknowledge.

RPCs

Method	Path
PollEvents	`POST /v1/ssf/streams/{id}/events:poll`
AcknowledgeEvents	`POST /v1/ssf/streams/{id}/events:ack`

Base URL: https://<Domain id="api"/>

Authentication: Bearer token scoped to the stream's audience (the audience that receives the events must auth itself on the poll).

{
  "sets": {
    "jti-1": "eyJhbGciOi...jwt-of-set-1...",
    "jti-2": "eyJhbGciOi...jwt-of-set-2..."
  }
}

Each entry is a signed Security Event Token (RFC 8417). Verify the signature against <Domain id="api"/>/.well-known/jwks.json.

POST /v1/ssf/streams/{id}/events:ack
{ "acks": ["jti-1", "jti-2"] }

Unacked events are re-delivered on the next poll, with an exponential backoff up to 24h.

SSF Streams

CRUD for Shared Signals Framework delivery streams.

SSF Configuration

Discover your tenant's SSF transmitter metadata.