API7 Docs
API7 GatewayAPI7 Enterprise Admin APIsDelete an alert policy

Delete an alert policy

DELETE /api/alert/policies/{alert_policy_id}

DELETE /api/alert/policies/{alert_policy_id}

Interactive request editor loads with JavaScript.

Authorization

X-API-KEY<token>

In: header

Path Parameters

alert_policy_id*string

Alert policy ID.

Response Body

application/json

application/json

curl -X DELETE "$API_BASE_URL/api/alert/policies/string"

Operation completed successfully with no response body.

""
Complete operation details and schema variants

DELETE /api/alert/policies/{alert_policy_id}

Delete an alert policy

Delete an existing alert policy so it no longer evaluates conditions or sends notifications. This action affects future alerting only and does not remove historical alert records.

Required IAM Permission: Action gateway:DeleteAlertPolicy, Resource arn:api7:gateway:alert/%s

Parameters

  • alert_policy_id (path, string, required): Alert policy ID.

Responses

  • 200: Operation completed successfully with no response body.
  • 400: Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.
  • value (object, optional): The specific resource.
  • error_msg (string, optional): The error message.

cURL

curl -X DELETE '$API_BASE_URL/api/alert/policies/{alert_policy_id}'