Retrieve an active user from a Dynatrace IAM organizational level by UUID with the Identity and Access Management API, using the level type and level ID.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/iam/v1/organizational-levels/{level-type}/{level-id}/users/{uuid} |
You use the level-type, level-id, and uuid path parameters to fetch one active user from an organizational level. The response returns the user successfully when Dynatrace authorizes your assignment to the associated account.
To execute this request, you need a platform token or OAuth access token with iam:users:read scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| level-type | string | Allowed values: account, environment | path | Required |
| level-id | string | Identifier of 'level-type'. Max allowed length is 36. For account use its UUID. For environment 'level-type' user has to be assigned to account to which the environment is assigned, user does not need any permissions in such environment | path | Required |
| uuid | string | User UUID | path | Required |
| Code | Type | Description |
|---|---|---|
| 200 | Rest | User fetched successfully |
| 401 | Public | Authorization header is missing or is incorrect. |
| 403 | Public | Execution user is not allowed to perform the action. |
| 404 | Public | Calling user is not assigned to the requested account or requested environment is not assigned to account that user is assigned to or the 'level-id' does not exist |
| 429 | Public | Too many requests have been sent - requests are throttled |
RestUserPublic objectCollection containing the paginated result
| Element | Type | Description |
|---|---|---|
| uid | string | - |
| string | - | |
| name | string | - |
| surname | string | - |
| description | string | - |
PublicExceptionMessage object| Element | Type | Description |
|---|---|---|
| error | Error | - |
ErrorResponse object| Element | Type | Description |
|---|---|---|
| code | integer | - |
| message | string | - |
| details | Error | - |
ErrorResponseDetails object| Element | Type | Description |
|---|---|---|
| missingScopes | string[] | - |
| constraintViolations | Error | - |
ErrorResponseConstraintViolation object| Element | Type | Description |
|---|---|---|
| path | string | - |
| message | string | - |
| parameterLocation | string | - |
{"uid": "string","email": "string","name": "string","surname": "string","description": "string"}
{"error": {"code": 1,"message": "string","details": {"missingScopes": ["string"],"constraintViolations": [{"path": "string","message": "string","parameterLocation": "string"}]}}}