---
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

---

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