---
title: "Ingest a batch of interaction events"
method: POST
path: "/events/batch"
tags: ["Events"]
---

# Ingest a batch of interaction events

`POST /events/batch`

## Request

- Base URL: `https://api.vp0.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.vp0.com/events/batch`
- Auth: none declared. Required headers: `user-agent`

## Headers

- `user-agent` string, required

## Request body

- IngestEventsDto
  - `anon_id` string
  - `session_id` string
  - `events` IngestEventDto[], required
    - `event_type` string, required
    - `content_id` string
    - `surface` string
    - `position` number
    - `dwell_ms` number
    - `value` number
    - `metadata` object
    - `client_ts` number

## Response `202`

---

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