---
title: "Record page views, activity and interactions for this browser session"
method: POST
path: "/api/activity/events"
tags: ["Activity"]
---

# Record page views, activity and interactions for this browser session

`POST /api/activity/events`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `x-sixb-csrf`
  - HTTP bearer
  - API key in header `x-sixb-share-grant` and API key in header `x-sixb-csrf`

A browser or shared-link session only; a native client's session gets 403. The visit belongs to the calling session.

## Request body

- object
  - `events` union[], required
    - union
      - object
        - `id` string, required
        - `type` 'page.view' | 'visit.activity', required
        - `route` string, required
        - `attribution` object
          - `source` string
          - `medium` string
          - `campaign` string
          - `referrer` string
      - object
        - `id` string, required
        - `type` 'ui.interaction', required
        - `name` string, required
        - `route` string, required

## Response `200`

Response for status 200

- object
  - `status` 'accepted' | 'disabled' | 'throttled', required
  - `accepted` number, required

## Other responses

- `400`: Response for status 400
- `403`: Response for status 403
- `429`: Response for status 429

## Changes

- **2026-10-20** `408316254546`: 1 breaking, 12 warning, 5 info
  - the `events/items/` request property type changed from `object` to no type (media type: application/json)
  - removed the request property `events/items/attribution` (media type: application/json)
  - removed the request property `events/items/attribution` (media type: application/x-www-form-urlencoded)
  - removed the request property `events/items/attribution` (media type: multipart/form-data)
  - …14 more
- **2026-10-20** `2529bf887ba6`: 15 breaking, 3 info
  - added the new required request property `events/items/id` (media type: application/json)
  - added the new required request property `events/items/id` (media type: application/x-www-form-urlencoded)
  - added the new required request property `events/items/id` (media type: multipart/form-data)
  - added the new required request property `events/items/route` (media type: application/json)
  - …14 more
- **2026-10-20** `8df745541b3a`: 1 breaking, 12 warning, 5 info
  - the `events/items/` request property type changed from `object` to no type (media type: application/json)
  - removed the request property `events/items/attribution` (media type: application/json)
  - removed the request property `events/items/attribution` (media type: application/x-www-form-urlencoded)
  - removed the request property `events/items/attribution` (media type: multipart/form-data)
  - …14 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/sixb-ai/apis/sixb-api/changes/api/activity/events/post.md)

---

[API](https://skmtc.dev/sixb-ai/apis/sixb-api.md) - [All operations](https://skmtc.dev/sixb-ai/apis/sixb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sixb-ai/apis/sixb-api/revisions/a227d682eaa2?raw)