Genesys Cloud - Main

We need to setup a new SSO provider as well as move over to a new domain, which requires we update the email address for each agent. What would be the best way to update agent accounts with the new email address? Is there a way to export agent accounts to excel to update it and then import it back into Cloud CX? Also, is it possible to delete a large number of agent accounts?

Thank you in advance for your help  

Hi Israel, 

You will first want to query this API endpoint to get the user details.  [GET /api/v2/users](https://developer.genesys.cloud/useragentman/users/#get-api-v2-users) 

You can then loop thru the initial response and add your code logic to make your email changes for-each $.result.email field using this API endpoint.  [PATCH /api/v2/users/{userId}](https://developer.genesys.cloud/useragentman/users/#patch-api-v2-users--userId-)

If you want to delete certain accounts, you can create new array of user objects that you want to delete from the initial response.  You can do this using this API endpoint.  [DELETE /api/v2/users/{userId}](https://developer.genesys.cloud/useragentman/users/#delete-api-v2-users--userId-)   

Important note: You will not be able to permanently expunge user accounts from Genesys Cloud. Doing so could result in orphaning all records previously associated with a expunged user. When you use the [DELETE /api/v2/users/{userId}] endpoint, the accounts simply no longer appear in the Genesys Cloud User Interface > Admin Menu > People & Permissions > People page list.  You will be able to find the delete accounts by using the [GET /api/v2/users] endpoint with either of the two expand parameter below...

• State = Any (active, inactive, deleted)
  •  "/api/v2/users?pageSize=500&pageNumber=1&sortOrder=descending&state=any"
• State = Deleted
  • "/api/v2/users?pageSize=500&pageNumber=1&sortOrder=descending&state=deleted"  

Keep in mind the [GET /api/v2/users] endpoint has pagination, so if you have more than 500 users in your system.  The response $.result.total will be greater than max pageSize of 500.  You will need to invoke a Do{This Code}Until($.result.entities.count -IsGreaterThanOrEqualTo $.result.total)

I hope this helps you. 

We need to setup a new SSO provider as well as move over to a new domain, which requires we update the email address for each agent. What would be the best way to update agent accounts with the new email address? Is there a way to export agent accounts to excel to update it and then import it back into Cloud CX? Also, is it possible to delete a large number of agent accounts?

Thank you in advance for your help  

Bulk updating users is a task that should be so simple, instead Genesys make it into a nightmare. We use another telephone product and you download a spreadsheet, update the details and upload. Job done. Genesys are so far behind on the simple things.

Hi Israel, 

You will first want to query this API endpoint to get the user details.  [GET /api/v2/users](https://developer.genesys.cloud/useragentman/users/#get-api-v2-users) 

You can then loop thru the initial response and add your code logic to make your email changes for-each $.result.email field using this API endpoint.  [PATCH /api/v2/users/{userId}](https://developer.genesys.cloud/useragentman/users/#patch-api-v2-users--userId-)

If you want to delete certain accounts, you can create new array of user objects that you want to delete from the initial response.  You can do this using this API endpoint.  [DELETE /api/v2/users/{userId}](https://developer.genesys.cloud/useragentman/users/#delete-api-v2-users--userId-)   

Important note: You will not be able to permanently expunge user accounts from Genesys Cloud. Doing so could result in orphaning all records previously associated with a expunged user. When you use the [DELETE /api/v2/users/{userId}] endpoint, the accounts simply no longer appear in the Genesys Cloud User Interface > Admin Menu > People & Permissions > People page list.  You will be able to find the delete accounts by using the [GET /api/v2/users] endpoint with either of the two expand parameter below...

• State = Any (active, inactive, deleted)
  •  "/api/v2/users?pageSize=500&pageNumber=1&sortOrder=descending&state=any"
• State = Deleted
  • "/api/v2/users?pageSize=500&pageNumber=1&sortOrder=descending&state=deleted"  

Keep in mind the [GET /api/v2/users] endpoint has pagination, so if you have more than 500 users in your system.  The response $.result.total will be greater than max pageSize of 500.  You will need to invoke a Do{This Code}Until($.result.entities.count -IsGreaterThanOrEqualTo $.result.total)

I hope this helps you. 

We need to setup a new SSO provider as well as move over to a new domain, which requires we update the email address for each agent. What would be the best way to update agent accounts with the new email address? Is there a way to export agent accounts to excel to update it and then import it back into Cloud CX? Also, is it possible to delete a large number of agent accounts?

Thank you in advance for your help  

Bulk updating users is a task that should be so simple, instead Genesys make it into a nightmare. We use another telephone product and you download a spreadsheet, update the details and upload. Job done. Genesys are so far behind on the simple things.

Hi Israel, 

You will first want to query this API endpoint to get the user details.  [GET /api/v2/users](https://developer.genesys.cloud/useragentman/users/#get-api-v2-users) 

You can then loop thru the initial response and add your code logic to make your email changes for-each $.result.email field using this API endpoint.  [PATCH /api/v2/users/{userId}](https://developer.genesys.cloud/useragentman/users/#patch-api-v2-users--userId-)

If you want to delete certain accounts, you can create new array of user objects that you want to delete from the initial response.  You can do this using this API endpoint.  [DELETE /api/v2/users/{userId}](https://developer.genesys.cloud/useragentman/users/#delete-api-v2-users--userId-)   

Important note: You will not be able to permanently expunge user accounts from Genesys Cloud. Doing so could result in orphaning all records previously associated with a expunged user. When you use the [DELETE /api/v2/users/{userId}] endpoint, the accounts simply no longer appear in the Genesys Cloud User Interface > Admin Menu > People & Permissions > People page list.  You will be able to find the delete accounts by using the [GET /api/v2/users] endpoint with either of the two expand parameter below...

• State = Any (active, inactive, deleted)
  •  "/api/v2/users?pageSize=500&pageNumber=1&sortOrder=descending&state=any"
• State = Deleted
  • "/api/v2/users?pageSize=500&pageNumber=1&sortOrder=descending&state=deleted"  

Keep in mind the [GET /api/v2/users] endpoint has pagination, so if you have more than 500 users in your system.  The response $.result.total will be greater than max pageSize of 500.  You will need to invoke a Do{This Code}Until($.result.entities.count -IsGreaterThanOrEqualTo $.result.total)

I hope this helps you. 

We need to setup a new SSO provider as well as move over to a new domain, which requires we update the email address for each agent. What would be the best way to update agent accounts with the new email address? Is there a way to export agent accounts to excel to update it and then import it back into Cloud CX? Also, is it possible to delete a large number of agent accounts?

Thank you in advance for your help