Skip to content

GET /notification/

Message Stream

GET
/notification/{topic}

Server-Sent Events stream for the given notification topic.

Authorization rules:

  • Auth is REQUIRED. Pass either ?ticket=<short-JWT> (issued by
    POST /notification/ticket, preferred for browser EventSource clients)
    or an Authorization: Bearer <JWT> header (for server-to-server).
  • For user:<key> topics, the caller's consumer_key MUST match <key>.
    The owner-match is enforced at ticket issuance; the header path checks
    it here directly.
  • Non-user topics (task, inventory, ...) require auth but are not
    owner-scoped in v1.

Emits: (SSE stream — emits are downstream NATS subjects)

Required scope: notification:stream:subscribe

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/auth"
Scopes:
  • "admin"User can access and edit users and system settings
  • "library"User can access and edit products
  • "production"User can access and edit production plans
  • "operator"User can access the operator panel and make production declarations

Parameters

Path Parameters

topic*
Type
string
Required

Query Parameters

ticket

Responses

Successful Response

text/event-stream

Samples

Powered by VitePress OpenAPI

Released under the Apache 2.0 License.