---
title: "Delete an invocation"
method: DELETE
path: "/invocations/{invocation_id}"
tags: ["invocation"]
deprecated: true
---

# Delete an invocation

`DELETE /invocations/{invocation_id}`

> **Deprecated.**

Use kill_invocation/cancel_invocation/purge_invocation instead.

## Path parameters

- `invocation_id` string, required

## Query parameters

- `mode` 'Cancel' | 'Kill' | 'Purge', nullable

## Response `202`

Accepted

## Other responses

- `400` — Bad request
- `404` — Not found
- `405` — Method not allowed
- `409` — Conflict
- `500` — Internal server error

## Changes

- **2026-01-30** `059a44500a5c` — 3 breaking, 4 info
  - removed the enum value `Cancel` from the `query` request parameter `mode`
  - removed the enum value `Kill` from the `query` request parameter `mode`
  - removed the enum value `Purge` from the `query` request parameter `mode`
  - for the `query` request parameter `mode`, the type/format was generalized from `string`/`` to ``/``
  - …3 more

[Change history](https://skmtc.dev/restatedev/apis/admin-api/changes/invocations/:invocation_id/delete.md)

---

[API](https://skmtc.dev/restatedev/apis/admin-api.md) · [All operations](https://skmtc.dev/restatedev/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/restatedev/admin-api/revisions/5361f4818c71/schema)