Skip to main content

users

Creates, updates, deletes, gets or lists a users resource.

Overview​

Nameusers
TypeResource
Idnvidia.orgs.users

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
idinteger (int64)unique Id of this user.
namestringuser name
client_idstringunique auth client id of this user. (wire: clientId)
starfleet_idstringunique starfleet id of this user. (wire: starfleetId)
created_datestringCreated date for this user (wire: createdDate)
emailstringEmail address of the user. This should be unique.
first_login_datestringLast time the user logged in (wire: firstLoginDate)
has_beta_accessbooleanDetermines if the user has beta access (wire: hasBetaAccess)
has_profilebooleanindicate if user profile has been completed. (wire: hasProfile)
has_signed_ai_foundry_partnerships_eulabooleanindicates if user has accepted AI Foundry Partnerships eula (wire: hasSignedAiFoundryPartnershipsEULA)
has_signed_aodteulabooleanindicates if user has accepted AODT End User License Agreement. (wire: hasSignedAODTEULA)
has_signed_base_command_eulabooleanindicates if user has accepted Base Command End User License Agreement. (wire: hasSignedBaseCommandEULA)
has_signed_base_command_manager_eulabooleanindicates if user has accepted Base Command Manager End User License Agreement. (wire: hasSignedBaseCommandManagerEULA)
has_signed_bio_ne_mo_eulabooleanindicates if user has accepted BioNeMo End User License Agreement. (wire: hasSignedBioNeMoEULA)
has_signed_container_publishing_eulabooleanindicates if user has accepted container publishing eula (wire: hasSignedContainerPublishingEULA)
has_signed_cu_opt_eulabooleanindicates if user has accepted CuOpt eula (wire: hasSignedCuOptEULA)
has_signed_earth_2_eulabooleanindicates if user has accepted Earth-2 eula (wire: hasSignedEarth2EULA)
has_signed_egx_eulaboolean[Deprecated] indicates if user has accepted EGX End User License Agreement. (wire: hasSignedEgxEULA)
has_signed_eulabooleanDetermines if the user has signed the NGC End User License Agreement. (wire: hasSignedEULA)
has_signed_fleet_command_eulabooleanindicates if user has accepted Fleet Command End User License Agreement. (wire: hasSignedFleetCommandEULA)
has_signed_llm_eulabooleanindicates if user has accepted LLM End User License Agreement. (wire: hasSignedLlmEULA)
has_signed_nvaieeulabooleanindicates if user has accepted Fleet Command End User License Agreement. (wire: hasSignedNVAIEEULA)
has_signed_nvidia_eulabooleanDetermines if the user has signed the NVIDIA End User License Agreement. (wire: hasSignedNvidiaEULA)
has_signed_nvqceulabooleanindicates if user has accepted Nvidia Quantum Cloud End User License Agreement. (wire: hasSignedNVQCEULA)
has_signed_omniverse_eulabooleanindicates if user has accepted Omniverse End User License Agreement. (wire: hasSignedOmniverseEULA)
has_signed_privacy_policybooleanDetermines if the user has signed the Privacy Policy. (wire: hasSignedPrivacyPolicy)
has_signed_third_party_registry_share_eulabooleanindicates if user has consented to share their registration info with other parties (wire: hasSignedThirdPartyRegistryShareEULA)
has_subscribed_to_emailbooleanDetermines if the user has opted in email subscription. (wire: hasSubscribedToEmail)
idp_typestringType of IDP, Identity Provider. Used for login. (NVIDIA, ENTERPRISE) (wire: idpType)
is_activebooleanDetermines if the user is active or not. (wire: isActive)
is_deletedbooleanIndicates if user was deleted from the system. (wire: isDeleted)
is_samlbooleanDetermines if the user is a SAML account or not. (wire: isSAML)
job_position_titlestringTitle of user's job position. (wire: jobPositionTitle)
last_login_datestringLast time the user logged in (wire: lastLoginDate)
rolesarrayList of roles that the user have
storage_quotaarrayStorage quota for this user. (wire: storageQuota)
updated_datestringUpdated date for this user (wire: updatedDate)
user_metadataobjectMetadata information about the user. (wire: userMetadata)
verifiedbooleanIs user's email or phone number is verified

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_by_starfleet_idselectstarfleet_idGet User details in org by starfleet Id
getselectuser_email_or_idGet info and role/invitation in an org by email or id
listselectexclude_from_team, page_number, page_size, qGet list of users in organization. (User Admin in org privileges required)
createinsertemailsend_email, idp_idCreates a User
deletedeleteidanonymizeRemove User from org.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
idstring
starfleet_idstring
user_email_or_idstring
anonymizebooleanIf anonymize is true, then org owner permission is required.
exclude_from_teamstringName of team to exclude members from
idp_idstringIf the IDP ID is provided then it is used instead of the one configured for the organization
page_numberinteger (int32)The page number of result
page_sizeinteger (int32)The page size of result
qobjectUser Search Parameters. Only 'filters' and 'orderBy' for 'name' and 'email' are implemented
send_emailboolean

SELECT examples​

Get User details in org by starfleet Id

SELECT
id,
name,
client_id,
starfleet_id,
created_date,
email,
first_login_date,
has_beta_access,
has_profile,
has_signed_ai_foundry_partnerships_eula,
has_signed_aodteula,
has_signed_base_command_eula,
has_signed_base_command_manager_eula,
has_signed_bio_ne_mo_eula,
has_signed_container_publishing_eula,
has_signed_cu_opt_eula,
has_signed_earth_2_eula,
has_signed_egx_eula,
has_signed_eula,
has_signed_fleet_command_eula,
has_signed_llm_eula,
has_signed_nvaieeula,
has_signed_nvidia_eula,
has_signed_nvqceula,
has_signed_omniverse_eula,
has_signed_privacy_policy,
has_signed_third_party_registry_share_eula,
has_subscribed_to_email,
idp_type,
is_active,
is_deleted,
is_saml,
job_position_title,
last_login_date,
roles,
storage_quota,
updated_date,
user_metadata,
verified
FROM nvidia.orgs.users
WHERE starfleet_id = '{{ starfleet_id }}' -- required
;

INSERT examples​

Creates a User

INSERT INTO nvidia.orgs.users (
email,
email_opt_in,
eula_accepted,
name,
role_type,
role_types,
salesforce_contact_job_role,
user_metadata,
send_email,
idp_id
)
SELECT
'{{ email }}' /* required */,
{{ email_opt_in }},
{{ eula_accepted }},
'{{ name }}',
'{{ role_type }}',
'{{ role_types }}',
'{{ salesforce_contact_job_role }}',
'{{ user_metadata }}',
'{{ send_email }}',
'{{ idp_id }}'
RETURNING
activation_token,
nca_role,
request_status,
user,
user_roles
;

DELETE examples​

Remove User from org.

DELETE FROM nvidia.orgs.users
WHERE id = '{{ id }}' --required
AND anonymize = '{{ anonymize }}'
;