---
title: "Run an approved purge"
method: POST
path: "/apiops/projects/{projectName}/lifecycle-purge-runs"
tags: ["LifecyclePurge"]
---

# Run an approved purge

`POST /apiops/projects/{projectName}/lifecycle-purge-runs`

## Request

- Base URL: `http://167.86.118.166:32080`
- URL: `http://167.86.118.166:32080/apiops/projects/{projectName}/lifecycle-purge-runs`
- Auth: none declared
- TypeScript: <https://skmtc.dev/apinizer/apis/apinizer-management-apis/docs/apiops/projects/:projectName/lifecycle-purge-runs/post.ts> (a function with typed inputs; its response is checked against the schema)

Queues the approved run and returns 202 + Location. Requires the Idempotency-Key header; the run itself is asynchronous and its first mutation is the point of no return.

## Path parameters

- `projectName` string, required

## Request body

- ApiOpsLifecyclePurgeRequestDTO
  - `mode` string
  - `subject` ApiOpsLifecycleSubjectDTO
    - `subjectType` 'ORGANIZATION' | 'CONSUMER' | 'APPLICATION' | 'API_CLIENT'
    - `consumerKey` string
    - `apiClientKey` string
    - `applicationKey` string
    - `organizationCode` string
  - `retentionDays` integer
  - `runId` string
  - `digest` string

## Response `200`

OK

- ApiOpsResponseLifecyclePurgeRunAccepted
  - `status` 'SUCCESS' | 'FAILURE'
  - `runId` string
  - `mode` string
  - `subjectType` 'ORGANIZATION' | 'CONSUMER' | 'APPLICATION' | 'API_CLIENT'
  - `subjectKey` string
  - `runStatus` string
  - `manifestDigest` string
  - `queuedAt` string, date-time

---

[API](https://skmtc.dev/apinizer/apis/apinizer-management-apis.md) - [All operations](https://skmtc.dev/apinizer/apis/apinizer-management-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/apinizer/apis/apinizer-management-apis/revisions/e083046b24cd?raw)