Managing users via the Retrium API

Enterprise Edition organizations can request access to the Retrium API to allow for easier user management.

This article applies to:

Enterprise Edition

Org Admins

If you're an Org Admin on Enterprise Edition and would like early access to the Retrium API, please reach out to your Account Manager or contact us at success@retrium.com

Table of Contents


Retrium API

Prerequisites to utilize the Retrium API:

  • Active Retrium Enterprise Edition subscription
  • Org Admin of the organization
  • Retrium API enabled for the organization from the Administration tab

apicredentials

If you do not see the Retrium API section in your Administration tab, please contact your Customer Success Manager at Retrium to enable it. 

The Retrium API is based on the SCIM 2.0 specification and allows for users to be:

  • Created and added to organization (users are not automatically added to Team Rooms; role will be set as Org Member)
  • Updated (first and last name)
  • Deactivated (removed from organization)


Okta integration

Prerequisites to utilize Retrium/Okta integration:

  • Active Retrium Enterprise Edition subscription
  • Org Admin of the organization
  • Retrium API enabled for the organization from the Administration tab
  • Okta Admin

If you added the Retrium tile to your Okta dashboard before October 1, 2022, please delete it and re-add the new Retrium tile. You will not be able to complete the implementation setup if you use the outdated Retrium integration.   

💡Additional documentation will be provided once the API is enabled for your organization in Retrium.

The Retrium/Okta integration is based on the SCIM specification and allows for users to be:

  • Created and added to organization (users are not automatically added to Team Rooms; role will be set as Org Member)
  • Updated (first and last name)
  • Deactivated (removed from organization)