---
title: "Changes to Ingest customer activity events"
method: POST
path: "/api/i/v1/{publicKey}/events"
---

# Changes to Ingest customer activity events

`POST /api/i/v1/{publicKey}/events`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 33 revisions.

- **2026-08-05** `7fac501c2674` — 15 breaking, 3 warning, 15 info
- **2026-07-15** `147173adbb3f` — 1 breaking

## Changes

- **2026-08-05** `7fac501c2674` — 15 breaking, 3 warning, 15 info
  - for the `path` request parameter `publicKey`, the minLength was increased from `0` to `1`
  - the `customerIdentity/customerId` request property's minLength was increased from `0` to `1`
  - the `userIdentity/userId` request property's minLength was increased from `0` to `1`
  - removed `#/components/schemas/PageviewEvent, #/components/schemas/CustomEvent, #/components/schemas/FormEvent, #/components/schemas/IdentifyEvent, #/components/schemas/EngagementEvent, #/components/schemas/CalendarEvent` from the `events/items/` request property `oneOf` list
  - added the pattern `^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$` to the request property `userIdentity/email`
  - added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `visitorId`
  - added 'propertyNames' constraint to the request property `customerIdentity/customerTraits`
  - added 'propertyNames' constraint to the request property `userIdentity/traits`
  - the `success` response property const value `false` was removed for the status `400`
  - the `success` response property const value `false` was removed for the status `500`
  - the `success` response property const value `true` was removed for the status `200`
  - removed the required property `errors/items/path` from the response with the `400` status
  - removed the required property `errors/items/path` from the response with the `500` status
  - removed the required property `message` from the response with the `400` status
  - removed the required property `message` from the response with the `500` status
  - the optional response header `X-RateLimit-Limit` removed for the status `200`
  - the optional response header `X-RateLimit-Remaining` removed for the status `200`
  - the optional response header `X-RateLimit-Reset` removed for the status `200`
  - api tag `Ingest API` removed
  - added the new optional request property `fingerprint`
  - added the new optional request property `sessionId`
  - added the new optional request property `userIdentity/fingerprint`
  - removed the pattern `^pk_` from the `path` request parameter `publicKey`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` to the `events/items/` request property `oneOf` list
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `429`
  - added the optional property `errors` to the response with the `200` status
  - added the required property `errors/items/index` to the response with the `400` status
  - added the required property `errors/items/index` to the response with the `500` status
  - added the required property `processed` to the response with the `200` status
  - added the required property `processed` to the response with the `400` status
  - added the required property `processed` to the response with the `500` status
  - added the success response with the status `207`
- **2026-07-15** `147173adbb3f` — 1 breaking
  - removed `#/components/schemas/StageEvent, #/components/schemas/BillingEvent` from the `events/items/` request property `oneOf` list

---

[Operation](https://skmtc.dev/outlitai/apis/outlit-api/docs/api/i/v1/:publicKey/events/post.md) · [API](https://skmtc.dev/outlitai/apis/outlit-api.md) · [Page](https://skmtc.dev/outlitai/apis/outlit-api/changes/api/i/v1/:publicKey/events/post)