Get user
Relative path: /v1/users/{userUuid}
Retrieves the details of a specific user based on their unique identifier.
Parameters in path
Name |
Type |
Required |
Description |
---|---|---|---|
userUuid |
string |
Yes |
Reference to the retrieved [user]. type: User |
Responses
Display Schema instead of an Example or vice-versa
Code |
Description |
Example |
Schema |
---|---|---|---|
200 |
Successful response. |
{ "user": { "activeProductIds": [ 0 ], "cloudOffice": { "hasMsLicense": true, "tenantReference": "string" }, "department": "string", "displayName": "string", "identities": [ { "createTime": "string", "providerReference": "string", "providerReferenceFormat": "IDENTITY_REFERENCE_FORMAT_UNSPECIFIED", "providerType": "IDENTITY_PROVIDER_TYPE_UNSPECIFIED", "updateTime": "string", "userName": "string" } ], "jobTitle": "string", "officeLocation": "string", "phoneNumbers": [ "string" ], "primaryEmailAddress": "string", "protectionStatus": "PROTECTION_STATUS_UNSPECIFIED", "proxyEmailAddresses": [ "string" ], "userGroupUuids": [ "string" ], "uuid": "string" } } |
{ "$ref": "v1GetUserResponse", "user": { "$ref": "v1User", "description": "Representation of physical user. Every user can have multiple identities and multiple accounts. Account is user's representation in some system, whereas identity is.", "activeProductIds": [ { "type": "integer", "format": "int64" } ], "cloudOffice": { "$ref": "v1CloudOfficeUser", "description": "Details of user related to their cloud office (e.g. Microsoft Office 365 or Google Workspace) origin.", "hasMsLicense": { "type": "boolean", "description": "For an user imported from Microsoft Office 365, true if the user has assigned Microsoft licenses. Info: Projection of assigned licenses from Graph API." }, "tenantReference": { "type": "string", "description": "Reference to cloud office tenant from where the user originates. The format might differ in dependence on the origin (e.g. Microsoft Office 365 uses predominantly UUID, whereas Google Workspace uses random string)." } }, "department": { "type": "string", "description": "The department to which the user belongs. Can be used for organizational categorization and role-based access control." }, "displayName": { "type": "string", "description": "The name of user displayed in address books. Usually, it is a full name, a combination of first name, middle and last names. Validation: - required - max length 255 Example: John Doe" }, "identities": [ { "$ref": "v1Identity", "description": "Represents an identity used to sign in to a user account. Each user can have multiple identities, such as Active Directory (AD), internet service provider (ISP) identity, or identities provided by Google, Facebook, or Microsoft, and so on. These identities enable user to sign in to the user accounts. It helps manage and track these different identities, ensuring seamless authentication and authorization across various platforms and services. Identity is managed by Identity Provider where the identity can also be verified (i.e. authenticated).", "createTime": { "type": "string", "description": "Date and time when the identity was created. Empty if the timestamp is unknown.", "format": "date-time" }, "providerReference": { "type": "string", "description": "The identifier used by the identity provider for the user. example: user123@company.com" }, "providerReferenceFormat": { "$ref": "v1IdentityReferenceFormat", "type": "string", "description": "Possible formats of user references. IDENTITY_REFERENCE_FORMAT_UNSPECIFIED: fallback IDENTITY_REFERENCE_FORMAT_EMAIL_ADDRES: User identity reference (login) is an email address. IDENTITY_REFERENCE_FORMAT_USER_NAME: User identity reference (login) is an username. IDENTITY_REFERENCE_FORMAT_USER_PRINCIPAL_NAME: User identity reference (login) is in Universal principal name (UPN) format. IDENTITY_REFERENCE_FORMAT_PHONE_NUMBER: User identity reference (login) is a telephone number. IDENTITY_REFERENCE_FORMAT_FEDERATED: An unique identifier for a user from an provider that can be in any format chosen by the provider.", "default": "IDENTITY_REFERENCE_FORMAT_UNSPECIFIED", "enum": [ "IDENTITY_REFERENCE_FORMAT_UNSPECIFIED", "IDENTITY_REFERENCE_FORMAT_EMAIL_ADDRES", "IDENTITY_REFERENCE_FORMAT_USER_NAME", "IDENTITY_REFERENCE_FORMAT_USER_PRINCIPAL_NAME", "IDENTITY_REFERENCE_FORMAT_PHONE_NUMBER", "IDENTITY_REFERENCE_FORMAT_FEDERATED" ] }, "providerType": { "$ref": "v1IdentityProviderType", "title": "Identity providers that can be used for authentication", "type": "string", "description": "IDENTITY_PROVIDER_TYPE_UNSPECIFIED: fallback IDENTITY_PROVIDER_TYPE_MICROSOFT: Represents Microsoft Entra ID (former Azure Active Directory, or Azure AD) as an identity provider for enterprise authentication. IDENTITY_PROVIDER_TYPE_GOOGLE: Represents Google as an identity provider for authentication via Google accounts. IDENTITY_PROVIDER_TYPE_FACEBOOK: Represents Facebook as an identity provider for authentication via Facebook accounts. IDENTITY_PROVIDER_TYPE_LOCAL: Represents a local provider that manages identities and authentication within the application's scope.", "default": "IDENTITY_PROVIDER_TYPE_UNSPECIFIED", "enum": [ "IDENTITY_PROVIDER_TYPE_UNSPECIFIED", "IDENTITY_PROVIDER_TYPE_MICROSOFT", "IDENTITY_PROVIDER_TYPE_GOOGLE", "IDENTITY_PROVIDER_TYPE_FACEBOOK", "IDENTITY_PROVIDER_TYPE_LOCAL" ] }, "updateTime": { "type": "string", "description": "Date and time when the identity was last updated. Empty if the timestamp is unknown.", "format": "date-time" }, "userName": { "type": "string", "description": "User name as a form of identity reference. Derived from provider reference if the provider reference format is suitable. Examples: - system\user - name.surname - login@somedomain.com Info: Inspired by: https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/sssd-user-ids" } } ], "jobTitle": { "type": "string", "description": "The job title of a user, representing their specific role or position within an organization or context. This attribute defines the user's job function and helps identify their responsibilities and role within the system." }, "officeLocation": { "type": "string", "description": "The physical office location or workplace of a user, representing the physical location or environment where the user is typically working or sitting while using the system. This can include an office, remote work location, or any other place relevant to the user's work activities." }, "phoneNumbers": [ { "type": "string" } ], "primaryEmailAddress": { "type": "string", "description": "The SMTP address for the user, for example, jeff@contoso.com. Changes to this property update the user's proxyAddresses collection to include the value as an SMTP address. This property can't contain accent characters. Validation: - valid email address format - max length 255 Example: john.doe@example.com" }, "protectionStatus": { "$ref": "v1ProtectionStatus", "type": "string", "description": "Aggregated status of protection, per context of specific asset. PROTECTION_STATUS_UNSPECIFIED: fallback PROTECTION_STATUS_UNPROTECTED: Status where selected asset is not protected by enabled ESET protection features. PROTECTION_STATUS_PENDING: Status where asset is not protected by enabled protection features yet, the protection is in pending state. The protection features are setting up. PROTECTION_STATUS_PARTIALLY_PROTECTED: Status where asset is protected by enabled protection features, with some complications, that require the attention. PROTECTION_STATUS_FULLY_PROTECTED: Status where asset is fully protected by enabled ESET protection features.", "default": "PROTECTION_STATUS_UNSPECIFIED", "enum": [ "PROTECTION_STATUS_UNSPECIFIED", "PROTECTION_STATUS_UNPROTECTED", "PROTECTION_STATUS_PENDING", "PROTECTION_STATUS_PARTIALLY_PROTECTED", "PROTECTION_STATUS_FULLY_PROTECTED" ] }, "proxyEmailAddresses": [ { "type": "string" } ], "userGroupUuids": [ { "type": "string" } ], "uuid": { "type": "string", "description": "Unique identifier of the entity. Must be collision free - two identifiers created anywhere in the world must not collide within entity parent scope. Unless a member of aggregate, the entity scope is always global. Although most of the times compliant with RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace, do not rely on it being a RFC UUID. Treat it as an opaque identifier. RFC UUID can be recognized by being formatted according to template xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx, as explained on wikipedia. UUID is used for referencing an entity, even across domains. Example: '123e4567-e89b-12d3-a456-426614174000'" } } } |
202 |
Response took too long; request cached. Response can be retrieved later using the response-id header. |
null |
[] |
400 |
One of the errors: 1. Bad or missing authorization. 2. Validation error. Invalid argument provided. |
null |
[] |
401 |
Token has expired or is invalid. |
null |
[] |
403 |
Access denied. Check permissions. |
null |
[] |
404 |
Requested resource not found. |
null |
[] |
429 |
Rate limit reached. Try again later. |
null |
[] |
500 |
Internal server failure. Try again later. |
null |
[] |
502 |
Internal server failure. Try again later. |
null |
[] |
503 |
Environment under maintenance. Try again later. |
null |
[] |
504 |
Action took too long; timeout reached |
null |
[] |