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.

Response body objects

The ErrorDto object

ElementTypeDescription
codenumber

The code of the error.

messagestring

A short description of the error.

errorsMapobject-

Response body JSON models

{
"code": 1,
"message": "string",
"errorsMap": {}
}

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.