---
title: "Record usage events"
method: POST
path: "/integrator/usage/events"
tags: ["usage"]
---

# Record usage events

`POST /integrator/usage/events`

Record a batch of integrator usage events.

Integrators push their own LLM token consumption.
No model or cost fields — only tokens and operation metadata.

## Request body

- RecordUsageEventsRequest — Batch of usage events from an integrator.
  - `events` RecordUsageEventRequest[], required
    - `workspace_id` string, uuid, required
    - `pot_id` string, uuid, nullable
    - `operation` string, required
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `latency_ms` number, nullable
    - `metadata` object, nullable

## Response `201`

Events recorded

- RecordUsageEventsResponse — Response after recording usage events.
  - `recorded` integer, required — Number of events recorded

## Other responses

- `400` — Invalid request
- `422` — Validation Error

---

[API](https://skmtc.dev/scipot/apis/scipot-core-api.md) · [All operations](https://skmtc.dev/scipot/apis/scipot-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scipot/scipot-core-api/revisions/e8712e9ffeae/schema)