Policy management API - DELETE a policy boundary

  • Latest Dynatrace
  • Reference
  • Published Nov 20, 2025

Deletes a policy boundary by uuid within a level. You can't delete a global-level boundary, as these are managed by Dynatrace.

DELETE

https://api.dynatrace.com/iam/v1/repo/account/{accountId}/boundaries/{policyBoundaryUuid}

Authentication

To execute this request, you need the Allow IAM policy configuration for environments (iam-policies-management) permission assigned to your token. To learn how to obtain and use it, see OAuth clients.

Parameters

ParameterTypeDescriptionInRequired
policyBoundaryUuid-

The ID of the required boundary.

pathrequired
accountId-

The ID of the policy boundary level. Use the UUID of the account.

pathrequired

Response

Response codes

CodeTypeDescription
204-

Successful response - policy boundary deleted

400ErrorDto

Failed. The request is invalid

404ErrorDto

Failed. The specified resource is not found.

Example

In this example, the request deletes a policy boundary with policy boundary UUID of 9a7b6c54-3d2e-4f10-a8b2-7cde9012f345 for the accountID f1a2b3c4-d5e6-7890-ab12-34cd56ef7890.

Curl

curl --request DELETE \
  --url https://api.dynatrace.com/iam/v1/repo/account/f1a2b3c4-d5e6-7890-ab12-34cd56ef7890/boundaries/9a7b6c54-3d2e-4f10-a8b2-7cde9012f345 \
  --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

https://api.dynatrace.com/iam/v1/repo/account/f1a2b3c4-d5e6-7890-ab12-34cd56ef7890/boundaries/9a7b6c54-3d2e-4f10-a8b2-7cde9012f345

Response code

204 - Successful response - policy boundary deleted.