API7 Docs
API7 GatewayAPI7 Enterprise Admin APIsDelete a permission policy

Delete a permission policy

DELETE /api/permission_policies/{permission_policy_id}

DELETE /api/permission_policies/{permission_policy_id}

Interactive request editor loads with JavaScript.

Authorization

X-API-KEY<token>

In: header

Path Parameters

permission_policy_id*string

Permission policy ID.

Length1 <= length

Response Body

application/json

application/json

curl -X DELETE "$API_BASE_URL/api/permission_policies/string"

Successful operation.

{
  "value": {}
}
Complete operation details and schema variants

DELETE /api/permission_policies/{permission_policy_id}

Delete a permission policy

Delete a permission policy. Ensure references are reviewed first to prevent accidental permission breakage. Required IAM Permission: Action iam:DeletePermissionPolicy, Resource arn:api7:iam:permissionpolicy/%s

Parameters

  • permission_policy_id (path, string, required): Permission policy ID.

Responses

  • 200: Successful operation.
  • value (object, optional): The specific resource.
  • 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/permission_policies/{permission_policy_id}'