---
title: "POST /api/public/tracking/events"
method: POST
path: "/api/public/tracking/events"
tags: ["PlayerTracking"]
---

# POST /api/public/tracking/events

`POST /api/public/tracking/events`

## Request

- Base URL: `https://api.wearelearning.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wearelearning.io/api/public/tracking/events`
- Auth: OAuth 2
  - Implicit: `https://login.wearelearning.io/authorize?audience=https://api.wearelearning.io`

## Request body

- TrackStoryEventRequestDto
  - `publicId` string, required
  - `storyId` string, uuid, required: A valid GUID
  - `playerId` string, uuid, required: A valid GUID
  - `sessionId` string, uuid, required: A valid GUID
  - `eventType` 'Started' | 'Completed' | 'QuizStarted' | 'QuizCompleted' | 'QuestionAnswered' | 'ResponseSelected', required
  - `externalSessionId` string, nullable
  - `metadata` unknown
  - `client` PlayerClientEnvironmentDto
    - `deviceType` string, nullable
    - `userAgent` string, nullable
    - `browserName` string, nullable
    - `browserVersion` string, nullable
    - `operatingSystem` string, nullable
    - `screenWidth` integer, nullable
    - `screenHeight` integer, nullable
    - `pixelRatio` number, double, nullable
    - `viewportWidth` integer, nullable
    - `viewportHeight` integer, nullable
    - `language` string, nullable
    - `timezoneOffsetMinutes` integer, nullable
    - `appVersion` string, nullable
    - `isTouchEnabled` boolean, nullable
    - `preferredContrastMode` string, nullable
  - `cmi5Params` Cmi5LaunchParamsDto
    - `fetchUrl` string, nullable
    - `endpoint` string, nullable
    - `authToken` string, nullable
    - `activityId` string, nullable
    - `registration` string, nullable
    - `actor` XApiActorDto
      - `name` string, nullable
      - `email` string, nullable
      - `mbox` string, nullable
      - `account` Cmi5AccountDto
        - `homePage` string, nullable
        - `name` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
    - `sessionId` string, nullable
  - `xApiParams` XApiLaunchParamsDto
    - `endpoint` string, nullable
    - `authToken` string, nullable
    - `activityId` string, nullable
    - `registration` string, nullable
    - `actor` XApiActorDto
      - `name` string, nullable
      - `email` string, nullable
      - `mbox` string, nullable
      - `account` Cmi5AccountDto
        - `homePage` string, nullable
        - `name` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
    - `sessionId` string, nullable

## Response `200`

OK

---

[API](https://skmtc.dev/wearelearning/apis/we-are-learning-api.md) - [All operations](https://skmtc.dev/wearelearning/apis/we-are-learning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wearelearning/apis/we-are-learning-api/revisions/e2ca5265db77?raw)