ListRoleUsers
Retrieve and manage users assigned to a specific role in Datadog MCP Server by inputting the role ID, with options to filter, sort, and paginate results for efficient user management.
Instructions
Gets all users of a role.
Path Parameters:
role_id (Required): The unique identifier of the role.
Query Parameters:
page[size]: Size for a given page. The maximum allowed value is 100.
page[number]: Specific page number to return.
sort: User attribute to order results by. Sort order is ascending by default. Sort order is descending if the field is prefixed by a negative sign, for example
sort=-name
. Options:name
,email
,status
.filter: Filter all users by the given string. Defaults to no filtering.
Responses:
200 (Success): OK
Content-Type:
application/json
Response Properties:
data: Array of returned users.
included: Array of objects related to the users.
Example:
403: Authentication error
Content-Type:
application/json
Response Properties:
errors: A list of errors.
Example:
404: Not found
Content-Type:
application/json
Response Properties:
errors: A list of errors.
Example:
429: Too many requests
Content-Type:
application/json
Response Properties:
errors: A list of errors.
Example:
Input Schema
Name | Required | Description | Default |
---|---|---|---|
filter | No | Filter all users by the given string. Defaults to no filtering. | |
page[number] | No | Specific page number to return. | |
page[size] | No | Size for a given page. The maximum allowed value is 100. | |
role_id | Yes | The unique identifier of the role. | |
sort | No | User attribute to order results by. Sort order is **ascending** by default. Sort order is **descending** if the field is prefixed by a negative sign, for example `sort=-name`. Options: `name`, `email`, `status`. | name |