v1

latestOpenAPI 3.1.02026-08-066984441.1 MB

users

Returns all users with their details.

Returns all users with their details like status, contact info and more. Returns all users if the user has read permissions on the feature user-master-data, otherwise returns only his own user. Archived users are excluded by default. You can include them by setting the 'showArchived' query parameter. If the permissions have UserTeamsData Feature, the filter for teams is applied. Beware that this will also include API users in the response.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

get/users

Query parameters

showArchivedboolean

Whether to show archived users.

pageinteger

Page number for pagination

pageSizeinteger

Number of items per page

orderbystring

The properties to order by

filterbystring

The filter expression to filter by

Headers

Authorizationstring required

Bearer authentication

Response

firstNamestring nullable

The firstname of the user.

lastNamestring nullable

The lastname of the user.

birthDatestring date-time nullable

The birthdate of the user.

genderstring nullable

The gender of the user.

titlestring nullable

The title of the user.

positionstring nullable

The position of the user.

languagestring nullable

The language preference of the user in ISO 639-1 format.

idstring uuid

The id of the user.

createdOnstring date-time

The date this user was created.

createdBystring uuid

The id of the user who created this user.

updatedOnstring date-time

The date when this user was last updated.

updatedBystring uuid

The id of the user who updated the entity.

isArchivedboolean

Whether this user is archived. Archived users are automatically inactive and only exist for reference purposes.

isDeactivatedboolean

Whether the user has been deactivated.

isAgentboolean

Whether this user represents an agent.

deactivatedOnstring date-time nullable

The date the user was deactivated.

deletedOnstring date-time nullable

The date the user was deleted (soft delete).

hasImageboolean

Whether the user has uploaded a profile image.

shouldMigrateToConnectboolean

Whether the user should be migrated to Connect.

resourceVersioninteger

The version of the entity, updated on every modification, to the ticks in UTC. Not identical to UpdatedOn.

isExternalboolean

True if this entity is coming from an external workspace (awork Connect).