Skip to main content

Hello community,

 

I'm currently working with the Miro API endpoint:

https://api.miro.com/v2/orgs/{org_id}/members
 

In this endpoint, I noticed that there is a `license` query parameter.

After conducting some tests within my enterprise organization, I found that I could only create users with the full and free license attributes.

I would like to understand how I can set some users to have the following license attributes:

- occasional, free_restricted, full trial and unknown. 

Could someone please explain the different license options available in Miro and how to implement them through the API?

Thanks in advance,

BR 

Vas

 

Hey ​@vkoko 

Here are the different type of licenses:

  1. Full License: This license allows users to create and edit boards, spaces, and templates. It is the most comprehensive license type.
     

  2. Free License: Users with this license can be added to spaces and boards and can view and comment on team-shared boards. They can be auto-converted to Full members based on certain actions.

  3. Free Restricted License: This license is assigned when the subscription runs out of paid Full licenses. Users with this license have limited access and need admin approval to get a Full license. They can view and comment but cannot edit boards.
     

  4. Occasional License: This is a less common license type and it may be used for users who need limited access.
     

  5. Full Trial License: This license provides a temporary Full license for a trial period (e.g., 7 days). It is used to allow Free Restricted users to experience full capabilities before deciding on an upgrade.
     

  6. Unknown License: This is likely a placeholder for users whose license type is not specified or recognized.
     

You can read more on the different licenses on this help article.

The only API that can change licenses is SCIM and it can only upgrade from Free or Free-Restricted to Full. Downgrade from Full to Free or Free-Restricted is not possible via API. And all the other other types (Free Trial and Occasional) are not covered by APIs.

You can read more about how this in our SCIM API docs. If you want to upgrade, you’ll need to do so via  Update user attribute by ID operation.


Hope this helps!

Reply


Terms & Conditions