Events

Tenant-facing Events API — poll lifecycle events (user., client., federation.*) forward from a cursor; the signature-free twin of tenant webhooks.

Base URL: https://api.stg.thoryn.org

Operations

Method	Path	Summary	Scopes
GET	/api/v1/events	Events List	tenant:events.read
GET	/api/v1/events/{id}	Events Get	tenant:events.read

Operation details

GET /api/v1/events

Events List

• Operation ID: eventsList
• Required scopes: tenant:events.read

Parameters:

Name	In	Required	Type	Description
type	query	no	string
actorId	query	no	string
organizationId	query	no	string
cursor	query	no	string
limit	query	no	integer

Responses:

Status	Description	Body
200	OK	object
401	Unauthorized — bearer token missing, expired, signed by an untrusted issuer, or missing the tnt tenant claim.	Problem (problem+json)
403	Forbidden — token lacks a required tenant:* scope, or the tnt claim does not match the tenant addressed by the request path.	Problem (problem+json)

GET /api/v1/events/{id}

Events Get

• Operation ID: eventsGet
• Required scopes: tenant:events.read

Parameters:

Name	In	Required	Type	Description
id	path	yes	string

Responses:

Status	Description	Body
200	OK	object
401	Unauthorized — bearer token missing, expired, signed by an untrusted issuer, or missing the tnt tenant claim.	Problem (problem+json)
403	Forbidden — token lacks a required tenant:* scope, or the tnt claim does not match the tenant addressed by the request path.	Problem (problem+json)