Create group API member_viewability_level options don't match UI

Hi, when creating group with this Box API:

There are 3 options to choose from for member_viewability_level:

  • admins_only - the enterprise admin, co-admins, group’s group admin
  • admins_and_members - all admins and group members
  • all_managed_users - all managed users in the enterprise

Also in admin UI there is Permission Setting on group page with also 3 options, but they don’t match.

When creating group with API, this is how chosen options are reflected in UI:
admins_only → Admins only
admins_and_members → Admins only
all_managed_users → Company

But I can’t figure out they way to set Permission Setting to “Group members” no matter what options I pass through API, how can I do this?

Hi @Eugene

Welcome to the forum!

You’re absolutely right, we are using different language between the administration console and the API:

The admins console:

API Docs:
image

So the equivalence is:

  • admin_only → Admins Only
  • admins_and_members → Group Members
  • all_managed_users → Company

I’m not sure I understand your other question:

Assuming you’re referring to the user role within the group (admin or member) you can set that up when you manage the group users:

Let us know if this is what you were looking for.

Cheers

Hi @rbarbosa, thank you for your reply!

My question was about this:

So the equivalence is:

  • admin_only → Admins Only
  • admins_and_members → Group Members
  • all_managed_users → Company

The problem it that it was not what was happening there. When I create group with this params:

{
    "name": "test23hlk0urasdlnalkj20m93",
    "member_viewability_level": "admins_and_members"
}

Permission Setting in UI of the created group will still be “Admins Only”. Also at least in UI its gonna be same if we pass “admin_only” to “member_viewability_level”. So no matter what I pass to “member_viewability_level”, it never becomes “Group Members” in UI.

But I think I figured it out, “Permission Setting” of the created group only becomes “Group Members” when I set both “invitability_level” and “member_viewability_level” to “admins_and_members” with query like this:

{
    "name": "test23hlk0urasdlnalkj20m93",
    "invitability_level": "admins_and_members",
    "member_viewability_level": "admins_and_members"
}

If one of “invitability_level” or “member_viewability_level” is missing in the query, group will be created with “Admins Only” permission setting.
I think I am fine with this as it solves the problem, but its quiet confusing as it never mentioned in docs (or I missed it somewhere) that Permission Setting depends both on “invitability_level” “member_viewability_level” in API.

Hi @Eugene

I completely missed your point, but I see it now.

And yes, it is missing from the documentation. It may be defaulting to admin_only and then forcing the other parameter.

We’ll investigate.

Thanks for spotting this.

Cheers