Receives a batch of behavior events from the Angular client.

Behavior: Accepts a batch of user behavior events (actions, navigation, interactions)
from the Nomad Angular UI. Events are validated, normalized, and stored in ClickHouse for
eventual aggregation into user profiles. Supports both regular HTTP requests with Bearer token
and sendBeacon requests with body-borne beacon token.

Authorization: Regular requests require Bearer token (class-level [Authorize]).
Beacon requests (navigator.sendBeacon) use beaconToken in request body since custom headers cannot be set.

Side Effects: Stores events in ClickHouse. Events are immutable once written (append-only).

Error Scenarios: Returns 400 if batch envelope is malformed. Returns 403 if event userId
doesn't match authenticated user. Returns 413 if batch exceeds size limits. Returns 207 if some events
are rejected. Returns 202 for full success.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The event batch containing events, viewport info, and optional beacon auth.

Represents a batch of user behavior events from the Angular client.

string | null

Gets or sets the unique identifier for this batch (UUID v4).
Used for idempotency - duplicate batches are silently accepted.

date-time

Gets or sets the timestamp when the batch was created on the client.

string | null

Gets or sets the user agent string from the browser.

string | null

Gets or sets the application version.

viewport
object

Represents viewport information from the client.

auth
object

Represents authentication information for beacon requests.

events
array of objects | null

Gets or sets the list of behavior events in this batch.

events
Headers
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json