---
title: "Kill an invocation"
method: PATCH
path: "/invocations/{invocation_id}/kill"
tags: ["invocation"]
---

# Kill an invocation

`PATCH /invocations/{invocation_id}/kill`

Forcefully terminates an invocation. **Warning**: This operation does not guarantee consistency for virtual object instance state,
in-flight invocations to other services, or other side effects. Use with caution.
For more information, see the [cancellation documentation](https://docs.restate.dev/services/invocation/managing-invocations#kill).

## Path parameters

- `invocation_id` string, required

## Response `200`

Invocation killed successfully

## Other responses

- `400`
- `404`
- `409` — The invocation was already completed, so it cannot be cancelled nor killed. You can instead purge the invocation, in order for restate to forget it.
- `503` — Error when routing the request within restate.

---

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