Delete Deploy History
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)
{
"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)
{
"error": "unauthorized_client",
"error_description": "Invalid token"
}
cURL Example
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 - List all deploy history records
- Rollback Deploy History - Rollback API proxy to a previous deployment