---
title: "Purge call history"
method: DELETE
path: "/history"
tags: ["history"]
---

# Purge call history

`DELETE /history`

Deletes recorded calls. With `X-Gripmock-Session` only the records of that session are removed, so a test can reset its own history without disturbing the calls of a parallel session; without the header the whole history is cleared.

## Response `200`

Number of records deleted

- HistoryPurged — Result of a history purge.
  - `deletedCount` integer, required — Number of records removed.
  - `session` string — Session the purge was scoped to, absent when the whole history was cleared.

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.net/bavix/apis/gripmock-api-schema.md) · [All operations](https://skmtc.net/bavix/apis/gripmock-api-schema/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bavix/gripmock-api-schema/revisions/48019d318a0f/schema)