Kloudless Blog

Kloudless Unified APIs enable you to code once and integrate many

We’re excited to announce support for full User and Group management capabilities in v2 of the Kloudless unified Team API! Check out the docs here.

The Kloudless Team API enables your application to access, create, update, and delete users and groups in popular SaaS applications such as Office 365 and G Suite. It also allows programmatic management of group membership through a unified interface, so that you don’t need to be concerned with the specifics of an individual application.

The v2 Team API is currently in preview and available today for Office 365 and G Suite. We plan on adding support for the remaining applications on our roadmap such as Dropbox Business in the near future. The v2 API can be used today by simply changing the version in the URL in API requests from v1 to v2, for the subset of API endpoints in our v2 API Docs.

Contact us to enable admin account connectivity and access the Team API described in this blog post.

We’ve highlighted some of the key improvements below.

Detailed metadata on users, groups, and memberships

In v1, we introduced support for basic metadata for users, including their ID, name, and email. We also included similar information for groups, and added in support for listing group members with their level of access. As you can tell, the support was fairly basic, and limited to the least amount of metadata required for a usable implementation. Any other information was only accessible as raw data using the X-Kloudless-Raw-Data: true header.

For comparison, here is a full list of attributes currently supported or in consideration for User data in v2:

  • User ID
  • Username
  • Primary email and alternate emails
  • Password (write-only, of course)
  • External Active Directory ID
  • Name and associated details (Given name; Surname)
  • Membership role, and corresponding name
  • Address and associated details
  • Phone numbers
  • Organization
  • Additional description
  • Record creation time
  • Last modified time

This information is far more detailed and provided where available. Group and Membership information have also been enhanced similarly.

In addition, v1’s representation of a Membership object was inconsistent as it classified it as a Group. This has been remedied in v2 with the introduction of a first-class Membership object that represents a Many-To-Many mapping of users and groups.

Full CRUD Support

The largest change in v2 is the introduction of new endpoints to create, update, and delete users and groups, as well as manage group membership.

Check out some of the example requests below:

Create a User

Add a User to a Group

Update a Group

Feedback

As mentioned above, contact us to enable access to the Team API. We’d love to hear from you on which features you’d like to see in v2 as well as any feedback on the current implementation.

Categories: