• Home
  • Dynatrace API
  • Account management
  • Policy management
  • Policies
  • DELETE a policy

Policy management API - DELETE a policy

Deletes an access policy. You can't delete a global-level policy, as these are managed by Dynatrace.

DELETE

https://api.dynatrace.com/iam/v1/repo/{levelType}/{levelId}/policies/{policyUuid}

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 Authentication.

Parameters

ParameterTypeDescriptionInRequired
levelTypestring

The type of the policy level. The following values are available:

  • account: An account policy applies to all environments of an account.
  • environment: An environment policy applies to a specific environment.

Each level inherits policies of a higher level and extends it with its own policies.

pathrequired
levelIdstring

The ID of the policy level. Use one of the following values, depending on the level type:

  • account: use the UUID of the account.
  • environment: use the ID of the environment.
pathrequired
policyUuidstring

The ID of the required policy.

pathrequired
forceboolean

Set to true to delete a policy that is still in use.

pathrequired

Response

Response codes

CodeTypeDescription
204

Success. The policy has been deleted. The response doesn't have a body.

400ErrorDto

Failed. The request is invalid

404ErrorDto

Failed. The specified resource is not found.

Example

In this example, the request deletes the apiExample policy from the POST request example. The response code of 204 indicates successful deletion.

Curl

bash
curl --request DELETE \ --url https://api.dynatrace.com/iam/v1/repo/environment/lde68092/policies/0c621587-f978-4c7b-89ee-d2045f611b03 \ --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

http
https://api.dynatrace.com/iam/v1/repo/environment/lde68092/policies/0c621587-f978-4c7b-89ee-d2045f611b03

Response code

204