---
title: "Revoke"
method: POST
path: "/workspaces/{wid}/retention/batches/{bid}/revoke"
tags: ["retention"]
---

# Revoke

`POST /workspaces/{wid}/retention/batches/{bid}/revoke`

## Request

- Base URL: `https://app.linerecon.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.linerecon.com/workspaces/{wid}/retention/batches/{bid}/revoke`
- Auth: none declared

## Path parameters

- `wid` string, uuid, required
- `bid` string, uuid, required

## Request body

- LifecycleRequest
  - `request_id` string, uuid, required

## Response `200`

Successful Response

- LifecycleJobView
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `batch_id` string, uuid, required
  - `revocation_id` string, uuid, required
  - `status` string, required
  - `attempts` integer, required
  - `error_code` string, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `cleanup_started_at` string, date-time, nullable, required
  - `content_purge_started_at` string, date-time, nullable
  - `content_purged_at` string, date-time, nullable
  - `content_purge_scope` string, nullable
  - `database_content_erased` boolean
  - `full_erasure_complete` boolean, required
  - `remaining_scope` string[], required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `413`: Content Too Large
- `422`: Unprocessable Content
- `429`: Too Many Requests
- `503`: Service Unavailable

---

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