---
title: "Retract a stored event"
method: DELETE
path: "/v1/events/{eventId}"
tags: ["Conversions"]
---

# Retract a stored event

`DELETE /v1/events/{eventId}`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/events/{eventId}`
- Auth: HTTP bearer

Retracts an event you already sent, for a refund, a cancelled order or a lost deal. It stops counting in campaign results and ad rules.

Each destination the event reached is told where the platform allows it: Google Ads retracts the conversion, and the other platforms report `not_supported` and keep their count. Sending the same `eventId` again stores it anew.

## Path parameters

- `eventId` string, required

## Query parameters

- `profileId` string, required

## Response `200`

The event was retracted. Check each destination.

- object
  - `eventId` string
  - `deleted` boolean
  - `destinations` EventCorrection[]
    - `accountId` string
    - `destinationId` string
    - `platform` string, nullable
    - `status` 'corrected' | 'not_supported' | 'failed': `corrected`: the platform changed its count. `not_supported`: the platform has no API to change a conversion it already counted. `failed`: see `error`.
    - `error` string, nullable

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `404`: Resource not found

## Changes

- **2026-11-10** `362eda0b2547`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/events/:eventId/delete.md)

---

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