> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Deploy History

> Deletes a specific deploy history record identified by its revision number. This operation is irreversible.

## Endpoint

```
DELETE /apiops/projects/{projectName}/apiProxies/{apiProxyName}/deploy-histories/{revision}/
```

## Authentication

Requires a Personal API Access Token.

### Header

```
Authorization: Bearer YOUR_TOKEN
```

## Request

### Headers

| Header        | Value          | Required |
| ------------- | -------------- | -------- |
| Authorization | Bearer {token} | Yes      |

### Path Parameters

| Parameter    | Type    | Required | Description                              |
| ------------ | ------- | -------- | ---------------------------------------- |
| projectName  | string  | Yes      | Project name                             |
| apiProxyName | string  | Yes      | API Proxy name                           |
| revision     | integer | Yes      | Deploy history revision number to delete |

### Query Parameters

None

### Request Body

This endpoint does not require a request body.

## Response

### Success Response (200 OK)

```json theme={null}
{
  "status": "SUCCESS",
  "resultMessage": "Deploy history record deleted successfully."
}
```

#### Response Fields

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| status        | string | Request status (`SUCCESS` or `FAILURE`) |
| resultMessage | string | Operation result message                |

### Error Response (401 Unauthorized)

```json theme={null}
{
  "error": "unauthorized_client",
  "error_description": "Invalid token"
}
```

## cURL Example

```bash theme={null}
curl -X DELETE \
  "https://demo.apinizer.com/apiops/projects/MyProject/apiProxies/petstore-api/deploy-histories/12/" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Notes and Warnings

* **Irreversible**: Deleted deploy history records cannot be recovered.
* **Persistent Records**: Both persistent and non-persistent records can be deleted via this endpoint.
* **Rollback Impact**: Deleting a deploy history record removes the associated API Proxy snapshot, which means you can no longer rollback to that revision.

## Permissions

User must have **`API_MANAGEMENT` + `MANAGE`** permission in the project.

## Related Documentation

* [List Deploy History](/api-reference/api-proxies/deployment/list-deploy-history) - List all deploy history records
* [Rollback Deploy History](/api-reference/api-proxies/deployment/rollback-deploy-history) - Rollback API proxy to a previous deployment