---
title: "Erase terminal signings in bulk"
method: POST
path: "/v1/erasure"
tags: ["Signings"]
---

# Erase terminal signings in bulk

`POST /v1/erasure`

## Request

- Base URL: `https://sign-api.tvarka.pro`
- URL: `https://sign-api.tvarka.pro/v1/erasure`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://sign-api.tvarka.pro/oauth/authorize`, token URL `https://sign-api.tvarka.pro/oauth/token`, scopes: `sign.read`, `sign.signings`)

Purges the client's terminal signing records and any order-owned
uploads. Pre-existing vault documents used through MCP are preserved.
In-flight signings are left untouched; erase one directly if
cancellation is intended.
Processes at most `limit` resources across signings and headless signatures
(default 20, maximum 100). After ten seconds of processing, finishes the
current resource and returns a continuation; a single storage operation
still depends on its transport timeout. Follow `nextCursor` while
`hasMore` is true. The cursor binds the client and the initial cutoff;
`before` may be omitted on continuation, or must match the first request.
Failed resources are listed and skipped by the cursor so they cannot
block later pages. After finishing the traversal, retry failures with
a new request without a cursor. `hasMore: false` ends this traversal,
not a claim that failed resources or later-terminal records were erased.

## Request body

- object
  - `before` string, date-time
  - `limit` integer
  - `cursor` string

## Response `200`

Number purged and number that must be retried.

- object
  - `purged` integer, required
  - `failed` integer, required
  - `signaturesPurged` integer: Present when headless signatures are enabled.
  - `failedResources` object[], required
    - `kind` 'signing' | 'signature', required
    - `id` string, uuid, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: An RFC 9457 problem document.
- `401`: An RFC 9457 problem document.
- `402`: An RFC 9457 problem document.
- `403`: An RFC 9457 problem document.
- `413`: An RFC 9457 problem document.
- `429`: An RFC 9457 problem document.
- `503`: An RFC 9457 problem document.

---

[API](https://skmtc.dev/tvarka/apis/tvarka-sign-api.md) · [All operations](https://skmtc.dev/tvarka/apis/tvarka-sign-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tvarka/apis/tvarka-sign-api/revisions/e3fdd995c013?raw)