Skip to content

POST /notification/ticket

Mint Ticket

POST
/notification/ticket

Issue a short-lived SSE ticket for the given topic.

The caller must hold a valid session JWT (Authorization header). The
returned ticket is scoped to the requested topic and the calling user,
and expires in expires_in seconds. Pass it as ?ticket=<value> when
opening the SSE stream.

For user:<key> topics, the caller's consumer_key must match <key>
a user cannot mint a ticket that lets them eavesdrop on another user's
personal notification stream.

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

Request Body

application/json
JSON
{
  
"topic": "user:user42"
}

Responses

Successful Response

application/json
JSON
{
  
"ticket": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyNDIiLCJ0b3BpYyI6InVzZXI6dXNlcjQyIn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
  
"expires_in": 60
}

Samples

Powered by VitePress OpenAPI

Released under the Apache 2.0 License.