---
title: "Delete (soft) a GMV Max automation"
method: DELETE
path: "/gmv-max/automations/{automation_id}"
tags: ["GMV Max"]
---

# Delete (soft) a GMV Max automation

`DELETE /gmv-max/automations/{automation_id}`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/gmv-max/automations/{automation_id}`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Soft-delete an automation (``status='deleted'``). The row remains in the DB but is excluded from list / detail views. Re-deleting an already-deleted automation is a no-op that still returns 200 (idempotent on the row itself).

Pending boost rows queued by this automation are cancelled in the background — best-effort, not awaited here. Single shop only.

## Path parameters

- `automation_id` integer, required

## Headers

- `Idempotency-Key` string, nullable
- `X-Dry-Run` string, nullable

## Response `200`

Automation deleted (or already deleted).

- unknown

## Other responses

- `403`: API key lacks `read_write` scope.
- `404`: Automation not found in this shop.
- `409`: Idempotency-Key conflict.
- `422`: Validation Error
- `429`: Write rate limit exceeded.

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-19** `291230805105`: 1 info
  - api operation id `delete_automation_gmv_max_automations__automation_id__delete` removed and replaced with `gmv_max_automation_delete`

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/gmv-max/automations/:automation_id/delete.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)