/genesys-users | Type: Application | PCID required: Yes
Tools
genesys_users_delete_group
Delete group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID |
genesys_users_delete_group_members
Remove members Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID |
ids | string | Yes | — | Comma 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
definitionId | string | Yes | — | Presence Definition ID |
genesys_users_delete_presence_source
Delete a Presence Source Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
sourceId | string | Yes | — | Presence Source ID |
genesys_users_delete_team
Delete team Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | Team ID |
genesys_users_delete_team_members
Delete team members Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | Team ID |
id | string | Yes | — | Comma separated list of member ids to remove |
genesys_users_delete_user
Delete user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_delete_user_station_associatedstation
Clear associated station Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_delete_user_station_defaultstation
Clear default station Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_get_authorization_divisionspermitted_paged_me
Returns which divisions the current user has the given permission in. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
permission | string | Yes | — | The permission string, including the object to access, e.g. routing:queue:view |
pageNumber | integer | No | — | Page number |
pageSize | integer | No | — | Page size |
genesys_users_get_documentation_gkn_search
Search gkn documentation using the q64 value returned from a previous search Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
genesys_users_get_documentation_search
Search documentation using the q64 value returned from a previous search Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
genesys_users_get_group
Get group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID |
genesys_users_get_group_individuals
Get all individuals associated with the group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID |
genesys_users_get_group_members
Get group members, includes individuals, owners, and dynamically included people Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID |
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
sortOrder | string | No | — | Ascending or descending sort order |
expand | any[] | No | — | Which fields, if any, to expand |
genesys_users_get_groups
Get a group list Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
id | any[] | No | — | id |
jabberId | any[] | No | — | A list of jabberIds to fetch by bulk (cannot be used with the “id” parameter) |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_users_get_groups_search
Search groups using the q64 value returned from a previous search Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
expand | any[] | No | — | expand |
genesys_users_get_locations_search
Search locations using the q64 value returned from a previous search Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
expand | any[] | No | — | Provides more details about a specified resource |
genesys_users_get_me
Get current user details. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | any[] | No | — | Which fields, if any, to expand. |
integrationPresenceSource | string | No | — | Get 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
definitionId | string | Yes | — | Presence Definition ID |
localeCode | string | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
deactivated | string | No | — | Deactivated query can be TRUE or FALSE |
divisionId | any[] | No | — | One or more division IDs. If nothing is provided, the definitions associated withthe list of divisions that the user has access to will be returned. |
localeCode | string | No | — | The locale code to fetch for the presence definition. Use ALL to fetch everything. |
genesys_users_get_presence_settings
Get the presence settingsgenesys_users_get_presence_source
Get a Presence Source Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
sourceId | string | Yes | — | Presence Source ID |
genesys_users_get_presence_sources
Get a list of Presence Sources Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
deactivated | string | No | — | Deactivated query can be TRUE or FALSE |
genesys_users_get_presence_user_primarysource
Get a user’s Primary Presence Source Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | user ID |
genesys_users_get_search
Search users using the q64 value returned from a previous search Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
expand | any[] | No | — | expand |
integrationPresenceSource | string | No | — | integrationPresenceSource |
genesys_users_get_search
Search using the q64 value returned from a previous search. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
expand | any[] | No | — | Which fields, if any, to expand |
profile | boolean | No | — | profile |
genesys_users_get_search_suggest
Suggest resources using the q64 value returned from a previous suggest query. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
expand | any[] | No | — | Which fields, if any, to expand |
profile | boolean | No | — | profile |
genesys_users_get_systempresences
Get the list of SystemPresencesgenesys_users_get_team
Get team Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | Team ID |
expand | string | No | — | Expand the division name |
genesys_users_get_team_members
Get team membership Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | Team ID |
pageSize | integer | No | — | Page size |
before | string | No | — | The cursor that points to the previous item in the complete list of teams |
after | string | No | — | The cursor that points to the next item in the complete list of teams |
expand | string | No | — | Expand the name on each user |
genesys_users_get_teams
Get Team listing Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Page size |
name | string | No | — | Return only teams whose names start with this value (case-insensitive matching) |
after | string | No | — | The cursor that points to the next item in the complete list of teams |
before | string | No | — | The cursor that points to the previous item in the complete list of teams |
expand | string | No | — | Expand the division on each team |
genesys_users_get_telephony_providers_edges_sites_search
Search sites using the q64 value returned from a previous search Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
expand | any[] | No | — | expand |
genesys_users_get_user
Get user. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
expand | any[] | No | — | Which 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. |
integrationPresenceSource | string | No | — | Gets an integration presence for a user instead of their default. |
state | string | No | — | Search for a user with this state |
genesys_users_get_user_callforwarding
Get a user’s CallForwarding Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_get_user_directreports
Get direct reports Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
expand | any[] | No | — | Which fields, if any, to expand |
genesys_users_get_user_geolocation
Get a user’s Geolocation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | user Id |
clientId | string | Yes | — | client Id |
genesys_users_get_user_outofoffice
Get a OutOfOffice Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_get_user_presence
Get a user’s Presence Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | user Id |
sourceId | string | Yes | — | Presence source ID |
genesys_users_get_user_presences_purecloud
Get a user’s Genesys Cloud presence. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | user Id |
genesys_users_get_user_profileskills
List profile skills for a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_get_user_queues
Get queues for user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
joined | boolean | No | — | Is joined to the queue |
divisionId | any[] | No | — | Division ID(s) |
genesys_users_get_user_roles
Returns a listing of roles and permissions for a user. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
subjectId | string | Yes | — | User ID |
genesys_users_get_user_routinglanguages
List routing languages assigned to a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_users_get_user_routingskills
List routing skills assigned to a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
sortOrder | string | No | — | Ascending or descending sort order |
genesys_users_get_user_routingstatus
Fetch the routing status of a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_get_user_state
Get user state information. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_get_user_station
Get station information for user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
genesys_users_get_user_superiors
Get superiors Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
expand | any[] | No | — | Which fields, if any, to expand |
genesys_users_get_user_trustors
List the organizations that have authorized/trusted the user. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
genesys_users_get_users
Get the list of available users. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
id | any[] | No | — | A list of user IDs to fetch by bulk |
jabberId | any[] | No | — | A list of jabberIds to fetch by bulk (cannot be used with the “id” parameter) |
sortOrder | string | No | — | Ascending or descending sort order |
expand | any[] | No | — | Which 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. |
integrationPresenceSource | string | No | — | Gets 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. |
state | string | No | — | Only list users of this state |
genesys_users_get_users_me
Get current user details. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | any[] | No | — | Which fields, if any, to expand. |
integrationPresenceSource | string | No | — | Get 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | any[] | No | — | A comma separated list of user IDs to fetch their presence status in bulk. Limit 50. |
genesys_users_get_voicemail_search
Search voicemails using the q64 value returned from a previous search Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q64 | string | Yes | — | q64 |
expand | any[] | No | — | expand |
genesys_users_patch_team
Update team Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | Team ID |
dateCreated | string | No | — | Last modified datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateModified | string | No | — | Last modified datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | Team information. |
division | object | No | — | division |
id | string | No | — | The globally unique identifier for the object. |
memberCount | integer | No | — | Number of members in a team |
name | string | Yes | — | The team name |
selfUri | string | No | — | The URI for this object |
genesys_users_patch_user
Update user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
acdAutoAnswer | boolean | No | — | The value that denotes if acdAutoAnswer is set on the user |
addresses | any[] | No | — | Email address, phone number, and/or extension for this user. One entry is allowed per media type |
biography | object | No | — | biography |
certifications | any[] | No | — | certifications |
chat | object | No | — | chat |
department | string | No | — | department |
email | string | No | — | |
employerInfo | object | No | — | employerInfo |
groups | any[] | No | — | The groups the user is a member of |
id | string | No | — | The globally unique identifier for the object. |
images | any[] | No | — | images |
locations | any[] | No | — | The user placement at each site location. |
manager | string | No | — | manager |
name | string | No | — | name |
preferredName | string | No | — | Preferred full name of agent |
primaryContactInfo | any[] | No | — | The address(s) used for primary contact. Updates to the corresponding address in the addresses list will be reflected here. |
profileSkills | any[] | No | — | Profile skills possessed by the user |
selfUri | string | No | — | The URI for this object |
state | string | No | — | The 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. |
title | string | No | — | title |
username | string | No | — | username |
version | integer | Yes | — | This 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
calls | any[] | No | — | An ordered list of CallRoutes to be executed when CallForwarding is enabled |
enabled | boolean | No | — | Whether or not CallForwarding is enabled |
id | string | No | — | The globally unique identifier for the object. |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | No | — | name |
phoneNumber | string | No | — | This property is deprecated. Please use the calls property |
selfUri | string | No | — | The URI for this object |
user | object | No | — | user |
voicemail | string | No | — | The type of voicemail to use with the callForwarding configuration |
genesys_users_patch_user_geolocation
Patch a user’s Geolocation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | user Id |
clientId | string | Yes | — | client Id |
city | string | No | — | city |
country | string | No | — | country |
id | string | No | — | The globally unique identifier for the object. |
latitude | number | No | — | latitude |
locations | any[] | No | — | locations |
longitude | number | No | — | longitude |
name | string | No | — | name |
primary | boolean | No | — | A boolean used to tell whether or not to set this geolocation client as the primary on a PATCH |
region | string | No | — | region |
selfUri | string | No | — | The URI for this object |
type | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | user Id |
sourceId | string | Yes | — | Presence source ID |
futurePresenceDefinition | object | No | — | futurePresenceDefinition |
id | string | No | — | The globally unique identifier for the object. |
message | string | No | — | message |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | No | — | name |
presenceDefinition | object | No | — | presenceDefinition |
primary | boolean | No | — | A boolean used to tell whether or not to set this presence source as the primary on a PATCH |
selfUri | string | No | — | The URI for this object |
source | string | No | — | Deprecated - The sourceID field should be used as a replacement. |
genesys_users_patch_user_presences_purecloud
Patch a Genesys Cloud user’s presence Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | user Id |
futurePresenceDefinition | object | No | — | futurePresenceDefinition |
id | string | No | — | The globally unique identifier for the object. |
message | string | No | — | message |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | No | — | name |
presenceDefinition | object | No | — | presenceDefinition |
primary | boolean | No | — | A boolean used to tell whether or not to set this presence source as the primary on a PATCH |
selfUri | string | No | — | The URI for this object |
source | string | No | — | Deprecated - The sourceID field should be used as a replacement. |
sourceId | string | No | — | Represents the ID of a registered source |
genesys_users_post_documentation_gkn_search
Search gkn documentation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_documentation_search
Search documentation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_group_members
Add members Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID |
memberIds | any[] | Yes | — | A list of the ids of the members to add. A maximum of 50 members are allowed per request. |
version | integer | No | — | The current group version. |
genesys_users_post_groups
Create a group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
addresses | any[] | No | — | addresses |
callsEnabled | boolean | No | — | Allow calls to be placed to this group. |
dateModified | string | No | — | Last modified date/time. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | description |
id | string | No | — | The globally unique identifier for the object. |
images | any[] | No | — | images |
includeOwners | boolean | No | — | Allow owners to be included as members of the group |
memberCount | integer | No | — | Number of members. |
name | string | Yes | — | The group name. |
ownerIds | any[] | No | — | Owners of the group |
rolesEnabled | boolean | No | — | Allow roles to be assigned to this group |
rulesVisible | boolean | Yes | — | Are membership rules visible to the person requesting to view the group |
selfUri | string | No | — | The URI for this object |
state | string | No | — | Active, inactive, or deleted state. |
type | string | Yes | — | Type of group. |
version | integer | No | — | Current version for this resource. |
visibility | string | Yes | — | Who can view this group |
genesys_users_post_groups_search
Search groups Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_locations_search
Search locations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | any[] | No | — | Provides more details about a specified resource |
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_presence_definitions
Create a Presence Definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
deactivated | boolean | No | — | deactivated |
divisionId | string | No | — | divisionId |
id | string | No | — | The globally unique identifier for the object. |
languageLabels | object | Yes | — | The label used for the definition in each specified language |
name | string | No | — | name |
selfUri | string | No | — | The URI for this object |
systemPresence | string | No | — | systemPresence |
type | string | No | — | The type of definition |
genesys_users_post_presence_sources
Create a Presence Source Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
deactivated | boolean | No | — | deactivated |
description | string | No | — | The description of the source |
id | string | No | — | The globally unique identifier for the object. |
name | string | Yes | — | The name of the source |
selfUri | string | No | — | The URI for this object |
type | string | No | — | The type of source |
genesys_users_post_search
Search users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
enforcePermissions | boolean | No | — | This property only applies to api/v2/user/search; when set to true add additional search criteria to filter users by: directory:user:view |
expand | any[] | No | — | Provides more details about a specified resource |
integrationPresenceSource | string | No | — | Gets 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. |
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_search
Search resources. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profile | boolean | No | — | profile |
aggregations | any[] | No | — | Aggregation criteria |
expand | any[] | No | — | Provides more details about a specified resource |
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | The search criteria |
returnFields | any[] | No | — | A 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. |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
types | any[] | Yes | — | Resource domain type to search |
genesys_users_post_search_suggest
Suggest resources. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profile | boolean | No | — | profile |
expand | any[] | No | — | Provides more details about a specified resource |
query | any[] | Yes | — | Suggest query |
types | any[] | Yes | — | Resource domain type to search |
genesys_users_post_search_teams_assign
Search users assigned to teams Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
enforcePermissions | boolean | No | — | This property only applies to api/v2/user/search; when set to true add additional search criteria to filter users by: directory:user:view |
expand | any[] | No | — | Provides more details about a specified resource |
integrationPresenceSource | string | No | — | Gets 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. |
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_speechandtextanalytics_transcripts_search
Search resources. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | The search criteria |
returnFields | any[] | No | — | returnFields |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
types | any[] | Yes | — | Resource domain type to search |
genesys_users_post_team_members
Add team members Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | Team ID |
memberIds | any[] | Yes | — | A list of the ids of the members to add or remove |
genesys_users_post_teams
Create a team Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
dateCreated | string | No | — | Last modified datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateModified | string | No | — | Last modified datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | Team information. |
division | object | No | — | division |
id | string | No | — | The globally unique identifier for the object. |
memberCount | integer | No | — | Number of members in a team |
name | string | Yes | — | The team name |
selfUri | string | No | — | The URI for this object |
genesys_users_post_teams_search
Search resources. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | Yes | — | Team Search Criteria |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_telephony_providers_edges_sites_search
Search sites Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | any[] | No | — | Provides more details about a specified resource |
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_users
Create user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
addresses | any[] | No | — | Email addresses and phone numbers for this user |
department | string | No | — | department |
divisionId | string | Yes | — | The division to which this user will belong |
email | string | Yes | — | User’s email and username |
name | string | Yes | — | User’s full name |
password | string | No | — | User’s password |
state | string | No | — | Optional initialized state of the user. If not specified, state will be Active if invites are sent, otherwise Inactive. |
title | string | No | — | title |
genesys_users_post_users_search
Search users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
enforcePermissions | boolean | No | — | This property only applies to api/v2/user/search; when set to true add additional search criteria to filter users by: directory:user:view |
expand | any[] | No | — | Provides more details about a specified resource |
integrationPresenceSource | string | No | — | Gets 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. |
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_post_voicemail_search
Search voicemails Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | any[] | No | — | Provides more details about a specified resource |
pageNumber | integer | No | — | The page of resources you want to retrieve |
pageSize | integer | No | — | The number of results per page |
query | any[] | No | — | query |
sort | any[] | No | — | Multi-value sort order, list of multiple sort values |
sortBy | string | No | — | The field in the resource that you want to sort the results by |
sortOrder | string | No | — | The sort order for results |
genesys_users_put_group
Update group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID |
addresses | any[] | No | — | addresses |
callsEnabled | boolean | No | — | Allow calls to be placed to this group. |
description | string | No | — | description |
id | string | No | — | The globally unique identifier for the object. |
images | any[] | No | — | images |
includeOwners | boolean | No | — | Allow owners to be included as members of the group |
name | string | No | — | The group name. |
ownerIds | any[] | No | — | Owners of the group |
rolesEnabled | boolean | No | — | Allow roles to be assigned to this group |
rulesVisible | boolean | No | — | Are membership rules visible to the person requesting to view the group |
selfUri | string | No | — | The URI for this object |
state | string | No | — | State of the group. |
version | integer | No | — | Current version for this resource. |
visibility | string | No | — | Who can view this group |
genesys_users_put_presence_definition
Update a Presence Definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
definitionId | string | Yes | — | Presence Definition ID |
deactivated | boolean | No | — | deactivated |
divisionId | string | No | — | divisionId |
id | string | No | — | The globally unique identifier for the object. |
languageLabels | object | Yes | — | The label used for the definition in each specified language |
name | string | No | — | name |
selfUri | string | No | — | The URI for this object |
systemPresence | string | No | — | systemPresence |
type | string | No | — | The type of definition |
genesys_users_put_presence_settings
Update the presence settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
defaultPrimaryPresenceRegisteredSourceId | string | No | — | The default primary presence registered source ID for the organization |
id | string | No | — | The globally unique identifier for the object. |
name | string | No | — | name |
requestingOffQueueEnabled | boolean | No | — | Whether requesting off queue is enabled for the organization |
restorePresenceSettings | object | No | — | restorePresenceSettings |
selfUri | string | No | — | The URI for this object |
genesys_users_put_presence_source
Update a Presence Source Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
sourceId | string | Yes | — | Presence Source ID |
deactivated | boolean | No | — | deactivated |
description | string | No | — | The description of the source |
id | string | No | — | The globally unique identifier for the object. |
name | string | Yes | — | The name of the source |
selfUri | string | No | — | The URI for this object |
type | string | No | — | The type of source |
genesys_users_put_presence_user_primarysource
Update a user’s Primary Presence Source Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | user ID |
id | string | No | — | The globally unique identifier for the object. |
name | string | No | — | name |
registered | boolean | No | — | Whether or not the source is registered |
selfUri | string | No | — | The URI for this object |
sourceId | string | No | — | The id of the source |
genesys_users_put_user_callforwarding
Update a user’s CallForwarding Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
calls | any[] | No | — | An ordered list of CallRoutes to be executed when CallForwarding is enabled |
enabled | boolean | No | — | Whether or not CallForwarding is enabled |
id | string | No | — | The globally unique identifier for the object. |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | No | — | name |
phoneNumber | string | No | — | This property is deprecated. Please use the calls property |
selfUri | string | No | — | The URI for this object |
user | object | No | — | user |
voicemail | string | No | — | The type of voicemail to use with the callForwarding configuration |
genesys_users_put_user_outofoffice
Update an OutOfOffice Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
active | boolean | No | — | active |
endDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
id | string | No | — | The globally unique identifier for the object. |
indefinite | boolean | No | — | indefinite |
name | string | No | — | name |
selfUri | string | No | — | The URI for this object |
startDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
user | object | No | — | user |
genesys_users_put_user_profileskills
Update profile skills for a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
body | any[] | Yes | — | Skills |
genesys_users_put_user_roles
Sets the user’s roles Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
subjectId | string | Yes | — | User ID |
body | any[] | Yes | — | List of roles |
genesys_users_put_user_routingstatus
Update the routing status of a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
startTime | string | No | — | The 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 |
status | string | No | — | Indicates 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
state | string | No | — | User’s current state. |
stateChangeDate | string | No | — | Date that the state was last changed. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
stateChangeReason | string | No | — | Reason for a change in the user’s state. |
version | integer | No | — | Version of this user. |
genesys_users_put_user_station_associatedstation_station_id
Set associated station Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
stationId | string | Yes | — | stationId |
genesys_users_put_user_station_defaultstation_station_id
Set default station Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID |
stationId | string | Yes | — | stationId |

