> ## 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 Proxy Group Deploy History

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

## Endpoint

```
DELETE /apiops/projects/{projectName}/apiProxyGroups/{apiProxyGroupName}/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                             |
| apiProxyGroupName | string  | Yes      | API Proxy Group 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": "Proxy Group 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/apiProxyGroups/PaymentAPIGroup/deploy-histories/8/" \
  -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.

## Permissions

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

## Related Documentation

* [List Proxy Group Deploy History](/api-reference/api-proxy-groups/deployment/list-deploy-history) - List all deploy history records
* [Get Deploy History Detail](/api-reference/api-proxy-groups/deployment/get-deploy-history-detail) - Get full detail of a deploy history record
