---
title: "Workos Start Deletion Dry Run"
method: POST
path: "/api/py/workos/deletion-dry-runs"
tags: ["workos"]
---

# Workos Start Deletion Dry Run

`POST /api/py/workos/deletion-dry-runs`

## Request

- Base URL: `https://api.getauctor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getauctor.com/api/py/workos/deletion-dry-runs`
- Auth: none declared

## Request body

- StartDeletionDryRunRequest
  - `request_id` string, required
  - `entity_type` 'user' | 'organization' | 'organization_membership', required
  - `entity_id` string, required
  - `rows_per_batch` integer

## Response `202`

Successful Response

- StartDeletionDryRunResponse
  - `workflow_id` string, required
  - `result` 'started' | 'already_running', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

## Changes

- **2026-10-21** `2d4b34404a6f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getauctor/apis/getauctor-api/changes/api/py/workos/deletion-dry-runs/post.md)

---

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