Try it free

Remove all-users permissions from a settings object

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Remove all-users permissions from a settings object in Dynatrace with the App Settings API, using the object ID and optional admin access.

DELETESaaShttps://{your-environment-id}.apps.dynatrace.com/v2/objects/{object-id}/permissions/all-users

Overview

You provide the object ID path parameter and can optionally set admin-access when you have app-settings:objects:admin permission. The operation removes the all-users permissions and returns no content.

Authentication

To execute this request, you need a platform token or OAuth access token with app-settings:objects:write scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
object-idstring

The ID of the required settings object

pathRequired
admin-accessboolean

If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects

queryOptional

Response

Response codes

CodeTypeDescription
204-

success

404ErrorResponse

No object available for the given objectId or the all-users accessor doesn't have any permissions on this object

429--
503--
4XX--
5XX--

Response body objects

The ErrorResponse object

ElementTypeDescription
errorError

Standard error response

The Error object

Standard error response

ElementTypeDescription
codenumber

The error code (HTTP response)

messagestring

The error message

retryAfterSecondsnumber

Number of seconds a request can be retried after a 'too many requests' error response.

detailsErrorDetails

Optional details of the error

The ErrorDetails object

Optional details of the error

ElementTypeDescription
errorRefstring

reference to the error occurrence in the internal self-monitoring, logging, etc.

constraintViolationsConstraintViolation[]

A list of constraint violations of input parameters (path, query, request body)

missingScopesstring[]

In case of a 403 - Forbidden response, a list of missing scopes necessary to successfully execute the request

The ConstraintViolation object

Contains information about a constraint violation caused by invalid input.

ElementTypeDescription
pathstring

The path of the parameter that caused the constraint violation

messagestring

The constraint violation description message

parameterLocationstring

Describes the general location of the violating parameter

The element can hold these values
  • PATH
  • QUERY
  • HEADER
  • PAYLOAD_BODY

Response body JSON models

{
"error": {
"code": 1,
"message": "string",
"retryAfterSeconds": 1,
"details": {
"errorRef": "string",
"constraintViolations": [
{
"path": "string",
"message": "string",
"parameterLocation": "PATH"
}
],
"missingScopes": [
"string"
]
}
}
}
Related tags
Platform APIDynatrace Platform