Class UsersApi
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classManage optional parameters to listUsers. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionAnonymize users.Anonymize users.Anonymize a list of users, removing their personal data.Anonymize users.createUser(UserCreateRequest body) Create a user.Create a user.Create a user for your organization.Create a user.voiddeleteUserInvitations(UUID userId) Delete a pending user's invitations.deleteUserInvitationsAsync(UUID userId) Delete a pending user's invitations.Cancel all pending invitations for a specified user.Delete a pending user's invitations.voiddisableUser(String userId) Disable a user.disableUserAsync(String userId) Disable a user.disableUserWithHttpInfo(String userId) Disable a user.disableUserWithHttpInfoAsync(String userId) Disable a user.Get the API client.Get current user.Get current user.Get the user associated with the current authentication context.Get current user.getInvitation(String userInvitationUuid) Get a user invitation.getInvitationAsync(String userInvitationUuid) Get a user invitation.getInvitationWithHttpInfo(String userInvitationUuid) Returns a single user invitation by its UUID.getInvitationWithHttpInfoAsync(String userInvitationUuid) Get a user invitation.Get user details.getUserAsync(String userId) Get user details.getUserIdentityProviders(String userId) Get identity provider overrides for a user.getUserIdentityProvidersAsync(String userId) Get identity provider overrides for a user.Get the identity provider overrides for a specific user in the organization.Get identity provider overrides for a user.getUserWithHttpInfo(String userId) Get a user in the organization specified by the user’suser_id.getUserWithHttpInfoAsync(String userId) Get user details.listUserOrganizations(String userId) Get a user organization.listUserOrganizationsAsync(String userId) Get a user organization.Get a user organization.Get a user organization.listUserPermissions(String userId) Get a user permissions.listUserPermissionsAsync(String userId) Get a user permissions.Get a user permission set.Get a user permissions.List all users.listUsers(UsersApi.ListUsersOptionalParameters parameters) List all users.List all users.listUsersAsync(UsersApi.ListUsersOptionalParameters parameters) List all users.Get the list of all users in the organization.List all users.List all users.List all users.Send invitation emails.Send invitation emails.Sends emails to one or more users inviting them to join the organization.Send invitation emails.voidsetApiClient(ApiClient apiClient) Set the API client.Update current user.Update current user.Edit the profile of the currently authenticated user.Update current user.updateUser(String userId, UserUpdateRequest body) Update a user.updateUserAsync(String userId, UserUpdateRequest body) Update a user.voidUpdate identity provider overrides for a user.Update identity provider overrides for a user.Set the identity provider overrides for a specific user in the organization.updateUserIdentityProvidersWithHttpInfoAsync(String userId, UpdateUserIdentityProvidersRequest body) Update identity provider overrides for a user.updateUserWithHttpInfo(String userId, UserUpdateRequest body) Edit a user.updateUserWithHttpInfoAsync(String userId, UserUpdateRequest body) Update a user.
-
Constructor Details
-
UsersApi
public UsersApi() -
UsersApi
-
-
Method Details
-
getApiClient
Get the API client.- Returns:
- API client
-
setApiClient
Set the API client.- Parameters:
apiClient- an instance of API client
-
anonymizeUsers
Anonymize users.See
anonymizeUsersWithHttpInfo(com.datadog.api.client.v2.model.AnonymizeUsersRequest).- Parameters:
body- (required)- Returns:
- AnonymizeUsersResponse
- Throws:
ApiException- if fails to make API call
-
anonymizeUsersAsync
Anonymize users.See
anonymizeUsersWithHttpInfoAsync(com.datadog.api.client.v2.model.AnonymizeUsersRequest).- Parameters:
body- (required)- Returns:
- CompletableFuture<AnonymizeUsersResponse>
-
anonymizeUsersWithHttpInfo
public ApiResponse<AnonymizeUsersResponse> anonymizeUsersWithHttpInfo(AnonymizeUsersRequest body) throws ApiException Anonymize a list of users, removing their personal data. This operation is irreversible. Requires theuser_access_managepermission.- Parameters:
body- (required)- Returns:
- ApiResponse<AnonymizeUsersResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 429 Too many requests -
-
anonymizeUsersWithHttpInfoAsync
public CompletableFuture<ApiResponse<AnonymizeUsersResponse>> anonymizeUsersWithHttpInfoAsync(AnonymizeUsersRequest body) Anonymize users.See
anonymizeUsersWithHttpInfo(com.datadog.api.client.v2.model.AnonymizeUsersRequest).- Parameters:
body- (required)- Returns:
- CompletableFuture<ApiResponse<AnonymizeUsersResponse>>
-
createUser
Create a user.See
createUserWithHttpInfo(com.datadog.api.client.v2.model.UserCreateRequest).- Parameters:
body- (required)- Returns:
- UserResponse
- Throws:
ApiException- if fails to make API call
-
createUserAsync
Create a user.See
createUserWithHttpInfoAsync(com.datadog.api.client.v2.model.UserCreateRequest).- Parameters:
body- (required)- Returns:
- CompletableFuture<UserResponse>
-
createUserWithHttpInfo
Create a user for your organization.- Parameters:
body- (required)- Returns:
- ApiResponse<UserResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 201 OK - 400 Bad Request - 403 Authentication error - 429 Too many requests -
-
createUserWithHttpInfoAsync
public CompletableFuture<ApiResponse<UserResponse>> createUserWithHttpInfoAsync(UserCreateRequest body) Create a user.See
createUserWithHttpInfo(com.datadog.api.client.v2.model.UserCreateRequest).- Parameters:
body- (required)- Returns:
- CompletableFuture<ApiResponse<UserResponse>>
-
deleteUserInvitations
Delete a pending user's invitations.- Parameters:
userId- The UUID of the user whose pending invitations should be canceled. (required)- Throws:
ApiException- if fails to make API call
-
deleteUserInvitationsAsync
Delete a pending user's invitations.- Parameters:
userId- The UUID of the user whose pending invitations should be canceled. (required)- Returns:
- CompletableFuture
-
deleteUserInvitationsWithHttpInfo
Cancel all pending invitations for a specified user. Requires theuser_access_invitepermission.- Parameters:
userId- The UUID of the user whose pending invitations should be canceled. (required)- Returns:
- ApiResponse<Void>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
deleteUserInvitationsWithHttpInfoAsync
Delete a pending user's invitations.- Parameters:
userId- The UUID of the user whose pending invitations should be canceled. (required)- Returns:
- CompletableFuture<ApiResponse<Void>>
-
disableUser
Disable a user.- Parameters:
userId- The ID of the user. (required)- Throws:
ApiException- if fails to make API call
-
disableUserAsync
Disable a user.- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture
-
disableUserWithHttpInfo
Disable a user. Can only be used with an application key belonging to an administrator user.- Parameters:
userId- The ID of the user. (required)- Returns:
- ApiResponse<Void>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 204 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
disableUserWithHttpInfoAsync
Disable a user.- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<ApiResponse<Void>>
-
getCurrentUser
Get current user.- Returns:
- UserResponse
- Throws:
ApiException- if fails to make API call
-
getCurrentUserAsync
Get current user.- Returns:
- CompletableFuture<UserResponse>
-
getCurrentUserWithHttpInfo
Get the user associated with the current authentication context. The response includes the user's profile attributes (name, email, handle, status, MFA state), along with related resources: the user's organization, assigned roles with their granted permissions, and team-scoped roles. No additional permissions are required beyond valid authentication.- Returns:
- ApiResponse<UserResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 429 Too many requests -
-
getCurrentUserWithHttpInfoAsync
Get current user.- Returns:
- CompletableFuture<ApiResponse<UserResponse>>
-
getInvitation
Get a user invitation.- Parameters:
userInvitationUuid- The UUID of the user invitation. (required)- Returns:
- UserInvitationResponse
- Throws:
ApiException- if fails to make API call
-
getInvitationAsync
Get a user invitation.- Parameters:
userInvitationUuid- The UUID of the user invitation. (required)- Returns:
- CompletableFuture<UserInvitationResponse>
-
getInvitationWithHttpInfo
public ApiResponse<UserInvitationResponse> getInvitationWithHttpInfo(String userInvitationUuid) throws ApiException Returns a single user invitation by its UUID.- Parameters:
userInvitationUuid- The UUID of the user invitation. (required)- Returns:
- ApiResponse<UserInvitationResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
getInvitationWithHttpInfoAsync
public CompletableFuture<ApiResponse<UserInvitationResponse>> getInvitationWithHttpInfoAsync(String userInvitationUuid) Get a user invitation.- Parameters:
userInvitationUuid- The UUID of the user invitation. (required)- Returns:
- CompletableFuture<ApiResponse<UserInvitationResponse>>
-
getUser
Get user details.- Parameters:
userId- The ID of the user. (required)- Returns:
- UserResponse
- Throws:
ApiException- if fails to make API call
-
getUserAsync
Get user details.- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<UserResponse>
-
getUserWithHttpInfo
Get a user in the organization specified by the user’suser_id.- Parameters:
userId- The ID of the user. (required)- Returns:
- ApiResponse<UserResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
getUserWithHttpInfoAsync
Get user details.- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<ApiResponse<UserResponse>>
-
getUserIdentityProviders
public UserOverrideIdentityProvidersResponse getUserIdentityProviders(String userId) throws ApiException Get identity provider overrides for a user.- Parameters:
userId- The ID of the user. (required)- Returns:
- UserOverrideIdentityProvidersResponse
- Throws:
ApiException- if fails to make API call
-
getUserIdentityProvidersAsync
public CompletableFuture<UserOverrideIdentityProvidersResponse> getUserIdentityProvidersAsync(String userId) Get identity provider overrides for a user.See
getUserIdentityProvidersWithHttpInfoAsync(java.lang.String).- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<UserOverrideIdentityProvidersResponse>
-
getUserIdentityProvidersWithHttpInfo
public ApiResponse<UserOverrideIdentityProvidersResponse> getUserIdentityProvidersWithHttpInfo(String userId) throws ApiException Get the identity provider overrides for a specific user in the organization. When a user has no overrides set, they use the organization's default identity providers.- Parameters:
userId- The ID of the user. (required)- Returns:
- ApiResponse<UserOverrideIdentityProvidersResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
getUserIdentityProvidersWithHttpInfoAsync
public CompletableFuture<ApiResponse<UserOverrideIdentityProvidersResponse>> getUserIdentityProvidersWithHttpInfoAsync(String userId) Get identity provider overrides for a user.- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<ApiResponse<UserOverrideIdentityProvidersResponse>>
-
listUserOrganizations
Get a user organization.- Parameters:
userId- The ID of the user. (required)- Returns:
- UserResponse
- Throws:
ApiException- if fails to make API call
-
listUserOrganizationsAsync
Get a user organization.See
listUserOrganizationsWithHttpInfoAsync(java.lang.String).- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<UserResponse>
-
listUserOrganizationsWithHttpInfo
public ApiResponse<UserResponse> listUserOrganizationsWithHttpInfo(String userId) throws ApiException Get a user organization. Returns the user information and all organizations joined by this user.- Parameters:
userId- The ID of the user. (required)- Returns:
- ApiResponse<UserResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
listUserOrganizationsWithHttpInfoAsync
public CompletableFuture<ApiResponse<UserResponse>> listUserOrganizationsWithHttpInfoAsync(String userId) Get a user organization.- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<ApiResponse<UserResponse>>
-
listUserPermissions
Get a user permissions.- Parameters:
userId- The ID of the user. (required)- Returns:
- PermissionsResponse
- Throws:
ApiException- if fails to make API call
-
listUserPermissionsAsync
Get a user permissions.- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<PermissionsResponse>
-
listUserPermissionsWithHttpInfo
public ApiResponse<PermissionsResponse> listUserPermissionsWithHttpInfo(String userId) throws ApiException Get a user permission set. Returns a list of the user’s permissions granted by the associated user's roles.- Parameters:
userId- The ID of the user. (required)- Returns:
- ApiResponse<PermissionsResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
listUserPermissionsWithHttpInfoAsync
public CompletableFuture<ApiResponse<PermissionsResponse>> listUserPermissionsWithHttpInfoAsync(String userId) Get a user permissions.- Parameters:
userId- The ID of the user. (required)- Returns:
- CompletableFuture<ApiResponse<PermissionsResponse>>
-
listUsers
List all users.See
listUsersWithHttpInfo(com.datadog.api.client.v2.api.UsersApi.ListUsersOptionalParameters).- Returns:
- UsersResponse
- Throws:
ApiException- if fails to make API call
-
listUsersAsync
List all users.See
listUsersWithHttpInfoAsync(com.datadog.api.client.v2.api.UsersApi.ListUsersOptionalParameters).- Returns:
- CompletableFuture<UsersResponse>
-
listUsers
List all users.See
listUsersWithHttpInfo(com.datadog.api.client.v2.api.UsersApi.ListUsersOptionalParameters).- Parameters:
parameters- Optional parameters for the request.- Returns:
- UsersResponse
- Throws:
ApiException- if fails to make API call
-
listUsersAsync
public CompletableFuture<UsersResponse> listUsersAsync(UsersApi.ListUsersOptionalParameters parameters) List all users.See
listUsersWithHttpInfoAsync(com.datadog.api.client.v2.api.UsersApi.ListUsersOptionalParameters).- Parameters:
parameters- Optional parameters for the request.- Returns:
- CompletableFuture<UsersResponse>
-
listUsersWithPagination
List all users.See
listUsersWithHttpInfo(com.datadog.api.client.v2.api.UsersApi.ListUsersOptionalParameters).- Returns:
- PaginationIterable<User>
-
listUsersWithPagination
public PaginationIterable<User> listUsersWithPagination(UsersApi.ListUsersOptionalParameters parameters) List all users.See
listUsersWithHttpInfo(com.datadog.api.client.v2.api.UsersApi.ListUsersOptionalParameters).- Returns:
- UsersResponse
-
listUsersWithHttpInfo
public ApiResponse<UsersResponse> listUsersWithHttpInfo(UsersApi.ListUsersOptionalParameters parameters) throws ApiException Get the list of all users in the organization. This list includes all users even if they are deactivated or unverified.- Parameters:
parameters- Optional parameters for the request.- Returns:
- ApiResponse<UsersResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 429 Too many requests -
-
listUsersWithHttpInfoAsync
public CompletableFuture<ApiResponse<UsersResponse>> listUsersWithHttpInfoAsync(UsersApi.ListUsersOptionalParameters parameters) List all users.See
listUsersWithHttpInfo(com.datadog.api.client.v2.api.UsersApi.ListUsersOptionalParameters).- Parameters:
parameters- Optional parameters for the request.- Returns:
- CompletableFuture<ApiResponse<UsersResponse>>
-
sendInvitations
Send invitation emails.See
sendInvitationsWithHttpInfo(com.datadog.api.client.v2.model.UserInvitationsRequest).- Parameters:
body- (required)- Returns:
- UserInvitationsResponse
- Throws:
ApiException- if fails to make API call
-
sendInvitationsAsync
Send invitation emails.See
sendInvitationsWithHttpInfoAsync(com.datadog.api.client.v2.model.UserInvitationsRequest).- Parameters:
body- (required)- Returns:
- CompletableFuture<UserInvitationsResponse>
-
sendInvitationsWithHttpInfo
public ApiResponse<UserInvitationsResponse> sendInvitationsWithHttpInfo(UserInvitationsRequest body) throws ApiException Sends emails to one or more users inviting them to join the organization.- Parameters:
body- (required)- Returns:
- ApiResponse<UserInvitationsResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 201 OK - 400 Bad Request - 403 Authentication error - 429 Too many requests -
-
sendInvitationsWithHttpInfoAsync
public CompletableFuture<ApiResponse<UserInvitationsResponse>> sendInvitationsWithHttpInfoAsync(UserInvitationsRequest body) Send invitation emails.See
sendInvitationsWithHttpInfo(com.datadog.api.client.v2.model.UserInvitationsRequest).- Parameters:
body- (required)- Returns:
- CompletableFuture<ApiResponse<UserInvitationsResponse>>
-
updateCurrentUser
Update current user.See
updateCurrentUserWithHttpInfo(com.datadog.api.client.v2.model.UserUpdateRequest).- Parameters:
body- (required)- Returns:
- UserResponse
- Throws:
ApiException- if fails to make API call
-
updateCurrentUserAsync
Update current user.See
updateCurrentUserWithHttpInfoAsync(com.datadog.api.client.v2.model.UserUpdateRequest).- Parameters:
body- (required)- Returns:
- CompletableFuture<UserResponse>
-
updateCurrentUserWithHttpInfo
public ApiResponse<UserResponse> updateCurrentUserWithHttpInfo(UserUpdateRequest body) throws ApiException Edit the profile of the currently authenticated user. Updatable fields includename,title,email, anddisabledstatus. Theidfield in the request body must match the authenticated user's UUID; a mismatch returns a 422 error. Email address changes are recorded in the audit trail. Requires theuser_self_profile_writepermission.- Parameters:
body- (required)- Returns:
- ApiResponse<UserResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 404 Not found - 422 Unprocessable Entity - 429 Too many requests -
-
updateCurrentUserWithHttpInfoAsync
public CompletableFuture<ApiResponse<UserResponse>> updateCurrentUserWithHttpInfoAsync(UserUpdateRequest body) Update current user.See
updateCurrentUserWithHttpInfo(com.datadog.api.client.v2.model.UserUpdateRequest).- Parameters:
body- (required)- Returns:
- CompletableFuture<ApiResponse<UserResponse>>
-
updateUser
Update a user.See
updateUserWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.UserUpdateRequest).- Parameters:
userId- The ID of the user. (required)body- (required)- Returns:
- UserResponse
- Throws:
ApiException- if fails to make API call
-
updateUserAsync
Update a user.See
updateUserWithHttpInfoAsync(java.lang.String, com.datadog.api.client.v2.model.UserUpdateRequest).- Parameters:
userId- The ID of the user. (required)body- (required)- Returns:
- CompletableFuture<UserResponse>
-
updateUserWithHttpInfo
public ApiResponse<UserResponse> updateUserWithHttpInfo(String userId, UserUpdateRequest body) throws ApiException Edit a user. Can only be used with an application key belonging to an administrator user.- Parameters:
userId- The ID of the user. (required)body- (required)- Returns:
- ApiResponse<UserResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 404 Not found - 422 Unprocessable Entity - 429 Too many requests -
-
updateUserWithHttpInfoAsync
public CompletableFuture<ApiResponse<UserResponse>> updateUserWithHttpInfoAsync(String userId, UserUpdateRequest body) Update a user.See
updateUserWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.UserUpdateRequest).- Parameters:
userId- The ID of the user. (required)body- (required)- Returns:
- CompletableFuture<ApiResponse<UserResponse>>
-
updateUserIdentityProviders
public void updateUserIdentityProviders(String userId, UpdateUserIdentityProvidersRequest body) throws ApiException Update identity provider overrides for a user.- Parameters:
userId- The ID of the user. (required)body- (required)- Throws:
ApiException- if fails to make API call
-
updateUserIdentityProvidersAsync
public CompletableFuture<Void> updateUserIdentityProvidersAsync(String userId, UpdateUserIdentityProvidersRequest body) Update identity provider overrides for a user.- Parameters:
userId- The ID of the user. (required)body- (required)- Returns:
- CompletableFuture
-
updateUserIdentityProvidersWithHttpInfo
public ApiResponse<Void> updateUserIdentityProvidersWithHttpInfo(String userId, UpdateUserIdentityProvidersRequest body) throws ApiException Set the identity provider overrides for a specific user in the organization. Pass an empty list to remove all overrides, reverting the user to the organization's default identity providers.- Parameters:
userId- The ID of the user. (required)body- (required)- Returns:
- ApiResponse<Void>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 204 No Content - 400 Bad Request - 403 Authentication error - 404 Not found - 429 Too many requests -
-
updateUserIdentityProvidersWithHttpInfoAsync
public CompletableFuture<ApiResponse<Void>> updateUserIdentityProvidersWithHttpInfoAsync(String userId, UpdateUserIdentityProvidersRequest body) Update identity provider overrides for a user.- Parameters:
userId- The ID of the user. (required)body- (required)- Returns:
- CompletableFuture<ApiResponse<Void>>
-