Skip to main content
Server path: /genesys-users | Type: Application | PCID required: Yes

Tools

ToolDescription
genesys_users_delete_groupDelete group
genesys_users_delete_group_membersRemove members
genesys_users_delete_presence_definitionDelete a Presence Definition
genesys_users_delete_presence_sourceDelete a Presence Source
genesys_users_delete_teamDelete team
genesys_users_delete_team_membersDelete team members
genesys_users_delete_userDelete user
genesys_users_delete_user_station_associatedstationClear associated station
genesys_users_delete_user_station_defaultstationClear default station
genesys_users_get_authorization_divisionspermitted_paged_meReturns which divisions the current user has the given permission in.
genesys_users_get_documentation_gkn_searchSearch gkn documentation using the q64 value returned from a previous search
genesys_users_get_documentation_searchSearch documentation using the q64 value returned from a previous search
genesys_users_get_groupGet group
genesys_users_get_group_individualsGet all individuals associated with the group
genesys_users_get_group_membersGet group members, includes individuals, owners, and dynamically included people
genesys_users_get_groupsGet a group list
genesys_users_get_groups_searchSearch groups using the q64 value returned from a previous search
genesys_users_get_locations_searchSearch locations using the q64 value returned from a previous search
genesys_users_get_meGet current user details.
genesys_users_get_presence_definitionGet a Presence Definition
genesys_users_get_presence_definitionsGet a list of Presence Definitions
genesys_users_get_presence_settingsGet the presence settings
genesys_users_get_presence_sourceGet a Presence Source
genesys_users_get_presence_sourcesGet a list of Presence Sources
genesys_users_get_presence_user_primarysourceGet a user’s Primary Presence Source
genesys_users_get_searchSearch users using the q64 value returned from a previous search
genesys_users_get_searchSearch using the q64 value returned from a previous search.
genesys_users_get_search_suggestSuggest resources using the q64 value returned from a previous suggest query.
genesys_users_get_systempresencesGet the list of SystemPresences
genesys_users_get_teamGet team
genesys_users_get_team_membersGet team membership
genesys_users_get_teamsGet Team listing
genesys_users_get_telephony_providers_edges_sites_searchSearch sites using the q64 value returned from a previous search
genesys_users_get_userGet user.
genesys_users_get_user_callforwardingGet a user’s CallForwarding
genesys_users_get_user_directreportsGet direct reports
genesys_users_get_user_geolocationGet a user’s Geolocation
genesys_users_get_user_outofofficeGet a OutOfOffice
genesys_users_get_user_presenceGet a user’s Presence
genesys_users_get_user_presences_purecloudGet a user’s Genesys Cloud presence.
genesys_users_get_user_profileskillsList profile skills for a user
genesys_users_get_user_queuesGet queues for user
genesys_users_get_user_rolesReturns a listing of roles and permissions for a user.
genesys_users_get_user_routinglanguagesList routing languages assigned to a user
genesys_users_get_user_routingskillsList routing skills assigned to a user
genesys_users_get_user_routingstatusFetch the routing status of a user
genesys_users_get_user_stateGet user state information.
genesys_users_get_user_stationGet station information for user
genesys_users_get_user_superiorsGet superiors
genesys_users_get_user_trustorsList the organizations that have authorized/trusted the user.
genesys_users_get_usersGet the list of available users.
genesys_users_get_users_meGet current user details.
genesys_users_get_users_presences_purecloud_bulkGet bulk user presences for a Genesys Cloud (PURECLOUD) presence source
genesys_users_get_voicemail_searchSearch voicemails using the q64 value returned from a previous search
genesys_users_patch_teamUpdate team
genesys_users_patch_userUpdate user
genesys_users_patch_user_callforwardingPatch a user’s CallForwarding
genesys_users_patch_user_geolocationPatch a user’s Geolocation
genesys_users_patch_user_presencePatch a user’s Presence
genesys_users_patch_user_presences_purecloudPatch a Genesys Cloud user’s presence
genesys_users_post_documentation_gkn_searchSearch gkn documentation
genesys_users_post_documentation_searchSearch documentation
genesys_users_post_group_membersAdd members
genesys_users_post_groupsCreate a group
genesys_users_post_groups_searchSearch groups
genesys_users_post_locations_searchSearch locations
genesys_users_post_presence_definitionsCreate a Presence Definition
genesys_users_post_presence_sourcesCreate a Presence Source
genesys_users_post_searchSearch users
genesys_users_post_searchSearch resources.
genesys_users_post_search_suggestSuggest resources.
genesys_users_post_search_teams_assignSearch users assigned to teams
genesys_users_post_speechandtextanalytics_transcripts_searchSearch resources.
genesys_users_post_team_membersAdd team members
genesys_users_post_teamsCreate a team
genesys_users_post_teams_searchSearch resources.
genesys_users_post_telephony_providers_edges_sites_searchSearch sites
genesys_users_post_usersCreate user
genesys_users_post_users_searchSearch users
genesys_users_post_voicemail_searchSearch voicemails
genesys_users_put_groupUpdate group
genesys_users_put_presence_definitionUpdate a Presence Definition
genesys_users_put_presence_settingsUpdate the presence settings
genesys_users_put_presence_sourceUpdate a Presence Source
genesys_users_put_presence_user_primarysourceUpdate a user’s Primary Presence Source
genesys_users_put_user_callforwardingUpdate a user’s CallForwarding
genesys_users_put_user_outofofficeUpdate an OutOfOffice
genesys_users_put_user_profileskillsUpdate profile skills for a user
genesys_users_put_user_rolesSets the user’s roles
genesys_users_put_user_routingstatusUpdate the routing status of a user
genesys_users_put_user_stateUpdate user state information.
genesys_users_put_user_station_associatedstation_station_idSet associated station
genesys_users_put_user_station_defaultstation_station_idSet default station

genesys_users_delete_group

Delete group Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID

genesys_users_delete_group_members

Remove members Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID
idsstringYesComma separated list of userIds to remove. A maximum of 50 members are allowed per request.

genesys_users_delete_presence_definition

Delete a Presence Definition Parameters:
ParameterTypeRequiredDefaultDescription
definitionIdstringYesPresence Definition ID

genesys_users_delete_presence_source

Delete a Presence Source Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesPresence Source ID

genesys_users_delete_team

Delete team Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesTeam ID

genesys_users_delete_team_members

Delete team members Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesTeam ID
idstringYesComma separated list of member ids to remove

genesys_users_delete_user

Delete user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_delete_user_station_associatedstation

Clear associated station Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_delete_user_station_defaultstation

Clear default station Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_get_authorization_divisionspermitted_paged_me

Returns which divisions the current user has the given permission in. Parameters:
ParameterTypeRequiredDefaultDescription
permissionstringYesThe permission string, including the object to access, e.g. routing:queue:view
pageNumberintegerNoPage number
pageSizeintegerNoPage size

Search gkn documentation using the q64 value returned from a previous search Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64

Search documentation using the q64 value returned from a previous search Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64

genesys_users_get_group

Get group Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID

genesys_users_get_group_individuals

Get all individuals associated with the group Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID

genesys_users_get_group_members

Get group members, includes individuals, owners, and dynamically included people Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID
pageSizeintegerNoPage size
pageNumberintegerNoPage number
sortOrderstringNoAscending or descending sort order
expandany[]NoWhich fields, if any, to expand

genesys_users_get_groups

Get a group list Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoPage size
pageNumberintegerNoPage number
idany[]Noid
jabberIdany[]NoA list of jabberIds to fetch by bulk (cannot be used with the “id” parameter)
sortOrderstringNoAscending or descending sort order

Search groups using the q64 value returned from a previous search Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64
expandany[]Noexpand

Search locations using the q64 value returned from a previous search Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64
expandany[]NoProvides more details about a specified resource

genesys_users_get_me

Get current user details. Parameters:
ParameterTypeRequiredDefaultDescription
expandany[]NoWhich fields, if any, to expand.
integrationPresenceSourcestringNoGet your presence for a given integration. This parameter will only be used when presence is provided as an “expand”.

genesys_users_get_presence_definition

Get a Presence Definition Parameters:
ParameterTypeRequiredDefaultDescription
definitionIdstringYesPresence Definition ID
localeCodestringNoThe locale code to fetch for the presence definition. Use ALL to fetch everything.

genesys_users_get_presence_definitions

Get a list of Presence Definitions Parameters:
ParameterTypeRequiredDefaultDescription
deactivatedstringNoDeactivated query can be TRUE or FALSE
divisionIdany[]NoOne or more division IDs. If nothing is provided, the definitions associated withthe list of divisions that the user has access to will be returned.
localeCodestringNoThe locale code to fetch for the presence definition. Use ALL to fetch everything.

genesys_users_get_presence_settings

Get the presence settings

genesys_users_get_presence_source

Get a Presence Source Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesPresence Source ID

genesys_users_get_presence_sources

Get a list of Presence Sources Parameters:
ParameterTypeRequiredDefaultDescription
deactivatedstringNoDeactivated query can be TRUE or FALSE

genesys_users_get_presence_user_primarysource

Get a user’s Primary Presence Source Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuser ID

Search users using the q64 value returned from a previous search Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64
expandany[]Noexpand
integrationPresenceSourcestringNointegrationPresenceSource

genesys_users_get_search

Search using the q64 value returned from a previous search. Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64
expandany[]NoWhich fields, if any, to expand
profilebooleanNoprofile

genesys_users_get_search_suggest

Suggest resources using the q64 value returned from a previous suggest query. Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64
expandany[]NoWhich fields, if any, to expand
profilebooleanNoprofile

genesys_users_get_systempresences

Get the list of SystemPresences

genesys_users_get_team

Get team Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesTeam ID
expandstringNoExpand the division name

genesys_users_get_team_members

Get team membership Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesTeam ID
pageSizeintegerNoPage size
beforestringNoThe cursor that points to the previous item in the complete list of teams
afterstringNoThe cursor that points to the next item in the complete list of teams
expandstringNoExpand the name on each user

genesys_users_get_teams

Get Team listing Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoPage size
namestringNoReturn only teams whose names start with this value (case-insensitive matching)
afterstringNoThe cursor that points to the next item in the complete list of teams
beforestringNoThe cursor that points to the previous item in the complete list of teams
expandstringNoExpand the division on each team

Search sites using the q64 value returned from a previous search Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64
expandany[]Noexpand

genesys_users_get_user

Get user. Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
expandany[]NoWhich fields, if any, to expand. Note, expand parameters are resolved with a best effort approach and not guaranteed to be returned. If requested expand information is absolutely required, it’s recommended to use specific API requests instead.
integrationPresenceSourcestringNoGets an integration presence for a user instead of their default.
statestringNoSearch for a user with this state

genesys_users_get_user_callforwarding

Get a user’s CallForwarding Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_get_user_directreports

Get direct reports Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
expandany[]NoWhich fields, if any, to expand

genesys_users_get_user_geolocation

Get a user’s Geolocation Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuser Id
clientIdstringYesclient Id

genesys_users_get_user_outofoffice

Get a OutOfOffice Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_get_user_presence

Get a user’s Presence Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuser Id
sourceIdstringYesPresence source ID

genesys_users_get_user_presences_purecloud

Get a user’s Genesys Cloud presence. Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuser Id

genesys_users_get_user_profileskills

List profile skills for a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_get_user_queues

Get queues for user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
pageSizeintegerNoPage size
pageNumberintegerNoPage number
joinedbooleanNoIs joined to the queue
divisionIdany[]NoDivision ID(s)

genesys_users_get_user_roles

Returns a listing of roles and permissions for a user. Parameters:
ParameterTypeRequiredDefaultDescription
subjectIdstringYesUser ID

genesys_users_get_user_routinglanguages

List routing languages assigned to a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
pageSizeintegerNoPage size
pageNumberintegerNoPage number
sortOrderstringNoAscending or descending sort order

genesys_users_get_user_routingskills

List routing skills assigned to a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
pageSizeintegerNoPage size
pageNumberintegerNoPage number
sortOrderstringNoAscending or descending sort order

genesys_users_get_user_routingstatus

Fetch the routing status of a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_get_user_state

Get user state information. Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_get_user_station

Get station information for user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID

genesys_users_get_user_superiors

Get superiors Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
expandany[]NoWhich fields, if any, to expand

genesys_users_get_user_trustors

List the organizations that have authorized/trusted the user. Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
pageSizeintegerNoPage size
pageNumberintegerNoPage number

genesys_users_get_users

Get the list of available users. Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoPage size
pageNumberintegerNoPage number
idany[]NoA list of user IDs to fetch by bulk
jabberIdany[]NoA list of jabberIds to fetch by bulk (cannot be used with the “id” parameter)
sortOrderstringNoAscending or descending sort order
expandany[]NoWhich fields, if any, to expand. Note, expand parameters are resolved with a best effort approach and not guaranteed to be returned. If requested expand information is absolutely required, it’s recommended to use specific API requests instead.
integrationPresenceSourcestringNoGets an integration presence for users instead of their defaults. This parameter will only be used when presence is provided as an “expand”. When using this parameter the maximum number of users that can be returned is 100.
statestringNoOnly list users of this state

genesys_users_get_users_me

Get current user details. Parameters:
ParameterTypeRequiredDefaultDescription
expandany[]NoWhich fields, if any, to expand.
integrationPresenceSourcestringNoGet your presence for a given integration. This parameter will only be used when presence is provided as an “expand”.

genesys_users_get_users_presences_purecloud_bulk

Get bulk user presences for a Genesys Cloud (PURECLOUD) presence source Parameters:
ParameterTypeRequiredDefaultDescription
idany[]NoA comma separated list of user IDs to fetch their presence status in bulk. Limit 50.

Search voicemails using the q64 value returned from a previous search Parameters:
ParameterTypeRequiredDefaultDescription
q64stringYesq64
expandany[]Noexpand

genesys_users_patch_team

Update team Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesTeam ID
dateCreatedstringNoLast modified datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateModifiedstringNoLast modified datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringNoTeam information.
divisionobjectNodivision
idstringNoThe globally unique identifier for the object.
memberCountintegerNoNumber of members in a team
namestringYesThe team name
selfUristringNoThe URI for this object

genesys_users_patch_user

Update user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
acdAutoAnswerbooleanNoThe value that denotes if acdAutoAnswer is set on the user
addressesany[]NoEmail address, phone number, and/or extension for this user. One entry is allowed per media type
biographyobjectNobiography
certificationsany[]Nocertifications
chatobjectNochat
departmentstringNodepartment
emailstringNoemail
employerInfoobjectNoemployerInfo
groupsany[]NoThe groups the user is a member of
idstringNoThe globally unique identifier for the object.
imagesany[]Noimages
locationsany[]NoThe user placement at each site location.
managerstringNomanager
namestringNoname
preferredNamestringNoPreferred full name of agent
primaryContactInfoany[]NoThe address(s) used for primary contact. Updates to the corresponding address in the addresses list will be reflected here.
profileSkillsany[]NoProfile skills possessed by the user
selfUristringNoThe URI for this object
statestringNoThe state of the user. This property can be used to restore a deleted user or transition between active and inactive. If specified, it is the only modifiable field.
titlestringNotitle
usernamestringNousername
versionintegerYesThis value should be the current version of the user. The current version can be obtained with a GET on the user before doing a PATCH.

genesys_users_patch_user_callforwarding

Patch a user’s CallForwarding Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
callsany[]NoAn ordered list of CallRoutes to be executed when CallForwarding is enabled
enabledbooleanNoWhether or not CallForwarding is enabled
idstringNoThe globally unique identifier for the object.
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoname
phoneNumberstringNoThis property is deprecated. Please use the calls property
selfUristringNoThe URI for this object
userobjectNouser
voicemailstringNoThe type of voicemail to use with the callForwarding configuration

genesys_users_patch_user_geolocation

Patch a user’s Geolocation Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuser Id
clientIdstringYesclient Id
citystringNocity
countrystringNocountry
idstringNoThe globally unique identifier for the object.
latitudenumberNolatitude
locationsany[]Nolocations
longitudenumberNolongitude
namestringNoname
primarybooleanNoA boolean used to tell whether or not to set this geolocation client as the primary on a PATCH
regionstringNoregion
selfUristringNoThe URI for this object
typestringNoA string used to describe the type of client the geolocation is being updated from e.g. ios, android, web, etc.

genesys_users_patch_user_presence

Patch a user’s Presence Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuser Id
sourceIdstringYesPresence source ID
futurePresenceDefinitionobjectNofuturePresenceDefinition
idstringNoThe globally unique identifier for the object.
messagestringNomessage
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoname
presenceDefinitionobjectNopresenceDefinition
primarybooleanNoA boolean used to tell whether or not to set this presence source as the primary on a PATCH
selfUristringNoThe URI for this object
sourcestringNoDeprecated - The sourceID field should be used as a replacement.

genesys_users_patch_user_presences_purecloud

Patch a Genesys Cloud user’s presence Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuser Id
futurePresenceDefinitionobjectNofuturePresenceDefinition
idstringNoThe globally unique identifier for the object.
messagestringNomessage
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoname
presenceDefinitionobjectNopresenceDefinition
primarybooleanNoA boolean used to tell whether or not to set this presence source as the primary on a PATCH
selfUristringNoThe URI for this object
sourcestringNoDeprecated - The sourceID field should be used as a replacement.
sourceIdstringNoRepresents the ID of a registered source

genesys_users_post_documentation_gkn_search

Search gkn documentation Parameters:
ParameterTypeRequiredDefaultDescription
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_documentation_search

Search documentation Parameters:
ParameterTypeRequiredDefaultDescription
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_group_members

Add members Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID
memberIdsany[]YesA list of the ids of the members to add. A maximum of 50 members are allowed per request.
versionintegerNoThe current group version.

genesys_users_post_groups

Create a group Parameters:
ParameterTypeRequiredDefaultDescription
addressesany[]Noaddresses
callsEnabledbooleanNoAllow calls to be placed to this group.
dateModifiedstringNoLast modified date/time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringNodescription
idstringNoThe globally unique identifier for the object.
imagesany[]Noimages
includeOwnersbooleanNoAllow owners to be included as members of the group
memberCountintegerNoNumber of members.
namestringYesThe group name.
ownerIdsany[]NoOwners of the group
rolesEnabledbooleanNoAllow roles to be assigned to this group
rulesVisiblebooleanYesAre membership rules visible to the person requesting to view the group
selfUristringNoThe URI for this object
statestringNoActive, inactive, or deleted state.
typestringYesType of group.
versionintegerNoCurrent version for this resource.
visibilitystringYesWho can view this group

genesys_users_post_groups_search

Search groups Parameters:
ParameterTypeRequiredDefaultDescription
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_locations_search

Search locations Parameters:
ParameterTypeRequiredDefaultDescription
expandany[]NoProvides more details about a specified resource
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_presence_definitions

Create a Presence Definition Parameters:
ParameterTypeRequiredDefaultDescription
deactivatedbooleanNodeactivated
divisionIdstringNodivisionId
idstringNoThe globally unique identifier for the object.
languageLabelsobjectYesThe label used for the definition in each specified language
namestringNoname
selfUristringNoThe URI for this object
systemPresencestringNosystemPresence
typestringNoThe type of definition

genesys_users_post_presence_sources

Create a Presence Source Parameters:
ParameterTypeRequiredDefaultDescription
deactivatedbooleanNodeactivated
descriptionstringNoThe description of the source
idstringNoThe globally unique identifier for the object.
namestringYesThe name of the source
selfUristringNoThe URI for this object
typestringNoThe type of source

genesys_users_post_search

Search users Parameters:
ParameterTypeRequiredDefaultDescription
enforcePermissionsbooleanNoThis property only applies to api/v2/user/search; when set to true add additional search criteria to filter users by: directory:user:view
expandany[]NoProvides more details about a specified resource
integrationPresenceSourcestringNoGets an integration presence for users instead of their defaults. This parameter will only be used when presence is provided as an “expand”. When using this parameter the maximum number of users that can be returned is 100.
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_search

Search resources. Parameters:
ParameterTypeRequiredDefaultDescription
profilebooleanNoprofile
aggregationsany[]NoAggregation criteria
expandany[]NoProvides more details about a specified resource
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]NoThe search criteria
returnFieldsany[]NoA List of strings. Possible values are any field in the resource you are searching on. The other option is to use ALL_FIELDS, when this is provided all fields in the resource will be returned in the search results.
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results
typesany[]YesResource domain type to search

genesys_users_post_search_suggest

Suggest resources. Parameters:
ParameterTypeRequiredDefaultDescription
profilebooleanNoprofile
expandany[]NoProvides more details about a specified resource
queryany[]YesSuggest query
typesany[]YesResource domain type to search

genesys_users_post_search_teams_assign

Search users assigned to teams Parameters:
ParameterTypeRequiredDefaultDescription
enforcePermissionsbooleanNoThis property only applies to api/v2/user/search; when set to true add additional search criteria to filter users by: directory:user:view
expandany[]NoProvides more details about a specified resource
integrationPresenceSourcestringNoGets an integration presence for users instead of their defaults. This parameter will only be used when presence is provided as an “expand”. When using this parameter the maximum number of users that can be returned is 100.
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_speechandtextanalytics_transcripts_search

Search resources. Parameters:
ParameterTypeRequiredDefaultDescription
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]NoThe search criteria
returnFieldsany[]NoreturnFields
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results
typesany[]YesResource domain type to search

genesys_users_post_team_members

Add team members Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesTeam ID
memberIdsany[]YesA list of the ids of the members to add or remove

genesys_users_post_teams

Create a team Parameters:
ParameterTypeRequiredDefaultDescription
dateCreatedstringNoLast modified datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateModifiedstringNoLast modified datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringNoTeam information.
divisionobjectNodivision
idstringNoThe globally unique identifier for the object.
memberCountintegerNoNumber of members in a team
namestringYesThe team name
selfUristringNoThe URI for this object

genesys_users_post_teams_search

Search resources. Parameters:
ParameterTypeRequiredDefaultDescription
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]YesTeam Search Criteria
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_telephony_providers_edges_sites_search

Search sites Parameters:
ParameterTypeRequiredDefaultDescription
expandany[]NoProvides more details about a specified resource
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_users

Create user Parameters:
ParameterTypeRequiredDefaultDescription
addressesany[]NoEmail addresses and phone numbers for this user
departmentstringNodepartment
divisionIdstringYesThe division to which this user will belong
emailstringYesUser’s email and username
namestringYesUser’s full name
passwordstringNoUser’s password
statestringNoOptional initialized state of the user. If not specified, state will be Active if invites are sent, otherwise Inactive.
titlestringNotitle

genesys_users_post_users_search

Search users Parameters:
ParameterTypeRequiredDefaultDescription
enforcePermissionsbooleanNoThis property only applies to api/v2/user/search; when set to true add additional search criteria to filter users by: directory:user:view
expandany[]NoProvides more details about a specified resource
integrationPresenceSourcestringNoGets an integration presence for users instead of their defaults. This parameter will only be used when presence is provided as an “expand”. When using this parameter the maximum number of users that can be returned is 100.
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_post_voicemail_search

Search voicemails Parameters:
ParameterTypeRequiredDefaultDescription
expandany[]NoProvides more details about a specified resource
pageNumberintegerNoThe page of resources you want to retrieve
pageSizeintegerNoThe number of results per page
queryany[]Noquery
sortany[]NoMulti-value sort order, list of multiple sort values
sortBystringNoThe field in the resource that you want to sort the results by
sortOrderstringNoThe sort order for results

genesys_users_put_group

Update group Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID
addressesany[]Noaddresses
callsEnabledbooleanNoAllow calls to be placed to this group.
descriptionstringNodescription
idstringNoThe globally unique identifier for the object.
imagesany[]Noimages
includeOwnersbooleanNoAllow owners to be included as members of the group
namestringNoThe group name.
ownerIdsany[]NoOwners of the group
rolesEnabledbooleanNoAllow roles to be assigned to this group
rulesVisiblebooleanNoAre membership rules visible to the person requesting to view the group
selfUristringNoThe URI for this object
statestringNoState of the group.
versionintegerNoCurrent version for this resource.
visibilitystringNoWho can view this group

genesys_users_put_presence_definition

Update a Presence Definition Parameters:
ParameterTypeRequiredDefaultDescription
definitionIdstringYesPresence Definition ID
deactivatedbooleanNodeactivated
divisionIdstringNodivisionId
idstringNoThe globally unique identifier for the object.
languageLabelsobjectYesThe label used for the definition in each specified language
namestringNoname
selfUristringNoThe URI for this object
systemPresencestringNosystemPresence
typestringNoThe type of definition

genesys_users_put_presence_settings

Update the presence settings Parameters:
ParameterTypeRequiredDefaultDescription
defaultPrimaryPresenceRegisteredSourceIdstringNoThe default primary presence registered source ID for the organization
idstringNoThe globally unique identifier for the object.
namestringNoname
requestingOffQueueEnabledbooleanNoWhether requesting off queue is enabled for the organization
restorePresenceSettingsobjectNorestorePresenceSettings
selfUristringNoThe URI for this object

genesys_users_put_presence_source

Update a Presence Source Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesPresence Source ID
deactivatedbooleanNodeactivated
descriptionstringNoThe description of the source
idstringNoThe globally unique identifier for the object.
namestringYesThe name of the source
selfUristringNoThe URI for this object
typestringNoThe type of source

genesys_users_put_presence_user_primarysource

Update a user’s Primary Presence Source Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuser ID
idstringNoThe globally unique identifier for the object.
namestringNoname
registeredbooleanNoWhether or not the source is registered
selfUristringNoThe URI for this object
sourceIdstringNoThe id of the source

genesys_users_put_user_callforwarding

Update a user’s CallForwarding Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
callsany[]NoAn ordered list of CallRoutes to be executed when CallForwarding is enabled
enabledbooleanNoWhether or not CallForwarding is enabled
idstringNoThe globally unique identifier for the object.
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoname
phoneNumberstringNoThis property is deprecated. Please use the calls property
selfUristringNoThe URI for this object
userobjectNouser
voicemailstringNoThe type of voicemail to use with the callForwarding configuration

genesys_users_put_user_outofoffice

Update an OutOfOffice Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
activebooleanNoactive
endDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
idstringNoThe globally unique identifier for the object.
indefinitebooleanNoindefinite
namestringNoname
selfUristringNoThe URI for this object
startDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
userobjectNouser

genesys_users_put_user_profileskills

Update profile skills for a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
bodyany[]YesSkills

genesys_users_put_user_roles

Sets the user’s roles Parameters:
ParameterTypeRequiredDefaultDescription
subjectIdstringYesUser ID
bodyany[]YesList of roles

genesys_users_put_user_routingstatus

Update the routing status of a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
startTimestringNoThe timestamp when the agent went into this state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
statusstringNoIndicates the Routing State of the agent. A value of OFF_QUEUE will be returned if the specified user does not exist.

genesys_users_put_user_state

Update user state information. Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
statestringNoUser’s current state.
stateChangeDatestringNoDate that the state was last changed. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
stateChangeReasonstringNoReason for a change in the user’s state.
versionintegerNoVersion of this user.

genesys_users_put_user_station_associatedstation_station_id

Set associated station Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
stationIdstringYesstationId

genesys_users_put_user_station_defaultstation_station_id

Set default station Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID
stationIdstringYesstationId