> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# usage.recorded

> A usage event was recorded. High volume — explicit opt-in.

## When this fires

Once per processed usage event, after the async processor persists it. This is the only **high-volume** webhook: it fires at your own ingest rate, so it is excluded from the family select-all in the dashboard and must be subscribed to explicitly.

Delivery is asynchronous — events are batched through the usage pipeline, so expect seconds of delay relative to the original `POST /usage/events` call. The idempotency key is the usage event ID, so retries never duplicate.

Use it to mirror usage into your own analytics store without polling.


## OpenAPI

````yaml /openapi/en/webhooks/2026-08-27.json webhook usage.recorded
openapi: 3.1.0
info:
  title: Commet Webhooks
  version: '2026-08-27'
  description: >-
    Outbound webhook events emitted by the Commet API. Each event is delivered
    as a signed POST to your configured endpoints.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.