---
title: "CorrectUsageEvents"
method: POST
path: "/gitpod.v1.BillingService/CorrectUsageEvents"
tags: ["gitpod.v1.BillingService"]
---

# CorrectUsageEvents

`POST /gitpod.v1.BillingService/CorrectUsageEvents`

Corrects previously-synced usage events by cancelling the originals and
 creating compensating negative-value events that flow through the normal
 sync pipeline to Stripe. Internal admin operation.

## Request body

- GitpodV1CorrectUsageEventsRequest
  - `idempotencyKeys` string[] — Idempotency keys of events to correct.
  - `reason` string — Why these events are being corrected (stored in cancel_reason and correction payload).

## Response `200`

Success

- GitpodV1CorrectUsageEventsResponse
  - `results` GitpodV1UsageEventCorrectionResult[]
    - `error` string — Error message if correction failed (e.g., event not found, already cancelled).
    - `idempotencyKey` string
    - `success` boolean

## Other responses

- `default` — Error

## Changes

- **2026-04-02** `dabc0ff98cd7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.BillingService/CorrectUsageEvents/post.md)

---

[API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.dev/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/44d50c2ac284/schema)