---
title: "Purge a completed invocation"
method: PATCH
path: "/invocations/{invocation_id}/purge"
tags: ["invocation"]
---

# Purge a completed invocation

`PATCH /invocations/{invocation_id}/purge`

Deletes all state associated with a completed invocation, including its journal and metadata.
This operation only applies to invocations that have already completed. For more information,
see the [purging documentation](https://docs.restate.dev/services/invocation/managing-invocations#purge).

## Path parameters

- `invocation_id` string, required

## Response `200`

Invocation purged successfully

## Other responses

- `400`
- `404`
- `409` — The invocation is not yet completed. An invocation can be purged only when completed.
- `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)