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.
Endpoint
DELETE /apiops/projects/{projectName}/apiProxyGroups/{apiProxyGroupName}/environments/{environmentName}/
Authentication
Requires a Personal API Access Token.
Authorization: Bearer YOUR_TOKEN
Request
| Header | Value | Required |
|---|
| Authorization | Bearer | Yes |
Path Parameters
| Parameter | Type | Required | Description |
|---|
| projectName | string | Yes | Project name |
| apiProxyGroupName | string | Yes | API Proxy Group name |
| environmentName | string | Yes | Environment name to undeploy from |
Query Parameters
None.
Request Body
Optional JSON body. When omitted, defaults are applied.
| Field | Type | Required | Description |
|---|
| description | string | No | Description/notes for the undeploy history record. Defaults to “Undeployed by APIOPS Api” if not provided. |
| persistent | boolean | No | If true, this undeploy history record will not be auto-deleted when the retention limit is reached. Defaults to false. |
Example
{
"description": "Rollback undeploy",
"persistent": true
}
Response
Success Response (200 OK)
{
"success": true,
"deploymentResult": {
"success": true,
"message": "Undeployment completed successfully",
"environmentResults": [
{
"environmentName": "production",
"success": true,
"message": "Undeployed successfully"
}
]
}
}
Error Response (400 Bad Request)
{
"error": "bad_request",
"error_description": "API Proxy Group (PaymentAPIGroup) is not found or user does not have privilege to access it!"
}
{
"error": "bad_request",
"error_description": "Environment (production) is not found or user does not have privilege to access it!"
}
cURL Example
curl -X DELETE \
"https://demo.apinizer.com/apiops/projects/MyProject/apiProxyGroups/PaymentAPIGroup/environments/production/" \
-H "Authorization: Bearer YOUR_TOKEN"
With Description and Persistent Flag
curl -X DELETE \
"https://demo.apinizer.com/apiops/projects/MyProject/apiProxyGroups/PaymentAPIGroup/environments/production/" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"description": "Rollback undeploy", "persistent": true}'
Notes and Warnings
-
Group Undeployment:
- All API Proxies in the group are undeployed together
- Group-level settings are also removed
-
Environment Must Exist:
- Environment must exist and be accessible
Permissions
- User must have
API_MANAGEMENT + DEPLOY_UNDEPLOY permission in the project
