Get Proxy Group Deploy History Detail

Returns the full detail of a specific API Proxy Group deploy history record identified by its revision number.

​

Endpoint

GET /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	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

​

Query Parameters

None

​

Request Body

This endpoint does not require a request body.

​

Response

​

Success Response (200 OK)

{
  "status": "SUCCESS",
  "resultList": [
    {
      "revision": 8,
      "username": "admin",
      "date": "2026-04-16T10:30:00Z",
      "description": "v2.1 group release",
      "environment": "production",
      "deploy": true,
      "persistent": false
    }
  ],
  "resultCount": 1
}

​

Response Fields

Field	Type	Description
status	string	Request status (SUCCESS or FAILURE)
resultList	array	Single-element array with the deploy history record
resultList[].revision	integer	Sequentially incrementing revision number (per API Proxy Group)
resultList[].username	string	User who performed the deployment
resultList[].date	string	ISO 8601 deployment timestamp
resultList[].description	string	Deployment description/notes
resultList[].environment	string	Target environment name
resultList[].deploy	boolean	true for deploy, false for undeploy
resultList[].persistent	boolean	Whether this record is protected from auto-deletion
resultCount	integer	Always 1 for a single record

​

Error Response (400 Bad Request)

{
  "error": "bad_request",
  "error_description": "Deploy history with revision (8) is not found for ApiProxyGroup (PaymentAPIGroup)!"
}

​

Error Response (401 Unauthorized)

{
  "error": "unauthorized_client",
  "error_description": "Invalid token"
}

​

cURL Example

curl -X GET \
  "https://demo.apinizer.com/apiops/projects/MyProject/apiProxyGroups/PaymentAPIGroup/deploy-histories/8/" \
  -H "Authorization: Bearer YOUR_TOKEN"

​

Permissions

User must have API_MANAGEMENT + VIEW permission in the project.

​

Related Documentation

• List Proxy Group Deploy History - List all deploy history records
• Delete Deploy History - Delete a deploy history record