Introduction to Organizations and Workspaces

“Organizations” and “Worskpaces” are two new API management layers that we introduced in your Console.

Frame 33719-min (1).jpg

Everything you do in your Console will now take place in an Organization. The Organization is the highest API management level, where you’ll define and access company-level information with an emphasis on contract and invoicing.

An Organization may contain one or more Worskpaces. Whereas the Organization is an administrative layer, a Workspace is an operational layer. It features a collection of domains, both sandbox and production, related to an Organization-managed contract and billing.

When you're brand new to Powens, it's best to keep it simple and start with just one Organization and one Workspace. But as you start using our Console for more things, and with more groups of people, you can have multiple domains separate by using various Workspaces.

Organization

Create an Organization

<aside> 💡 For most of you, we have already created the Organization. In this case, you do not need to create a new one.

</aside>

Organization - Create.gif

Let’s do that with the tap of a finger! Your Organization switcher will default display all the Organization associated with your email address. Here are the steps to follow to create a new one:

Manage roles in the Organization

Organization - Manage roles.gif

There are 3 roles:

Join an existing Organization

To join an existing organization, you need to ask an admin from that Organization to add you as a member. Then you will receive an email with a link to join. You’ll be prompted to sign in with your email and be placed into the Organization with the role associated with the invitation.

Invite someone to an Organization

Organization - Invite someone.gif

We bet that you will never walk alone! For that reason, you’ll want to bring other people into your Organization. Here is how you can invite people to join your Organization:

<aside> 💡 The Organization is the highest level of permission. By giving administrator rights to the Organization, you cascade administrator rights to the Workspaces and domains within it.

</aside>

Remove someone from an Organization

<aside> 💡 Organization administrators are the only ones who have permission to let someone go!

</aside>

Organization - Remove someone.gif

Group 33624-min (1).png

Workspace

Single Workspace Organization

For simplicity's sake, you are probably one of those Organizations that only have one Workspace. If for billing or organizational reasons, you need to create several Workspaces, please contact your CSM.

<aside> 💡 If you create an Organization, the first Workspace will be created automatically using the organization's name

</aside>

Multiple Workspace Organization

Several Workspaces to meet your organizational needs and to have different teams working on different projects but also to manage several levels of billing.

Create a new Workspace

WK - Create.gif

As easy as the creation of an Organization:

<aside> ⚠️ You may be forbidden to create a new workspace. By default you have one Workspace and you are limited to one. If you want to have more than that for invoicing or permissions purposes please contact your CSM or send us an email on [email protected].

</aside>

Manage roles in the Workspace

WK - Manage role.gif

There are 3 different roles:

<aside> 💡 Only organization and Workspace administrators can manage roles at the workspace level

</aside>

Join an existing Workspace

To join an existing Workspace, you need to ask an admin from that Workspace to add you as a member. Then you will receive an email with a link to join. You’ll be prompted to sign in with your email and be placed into the Workspace with the role associated with the invitation.

Invite someone to a Workspace

WK - Invite.gif

We bet that you will never walk alone! For that reason, you’ll want to bring other people into your Workspace. Here is how you can invite people to join your Workspace:

<aside> 💡 All Workspace members are by default members of the Organization. Only organization administrators can invite a new member inside a Workspace

</aside>

Rename a Workspace

WK - Rename.gif

Delete a Workspace

<aside> 💡 When you no longer need your Workspace, you can delete it. Before that, you need to remove all the domains and users which are inside it. This option is only available for Workspaces administrators.

</aside>

WK - Delete.gif

Group 33624-min (1).png

Domain

Create a new domain (sandbox or production) inside a Workspace

Domain - Create.gif

There is nothing simpler than that! You just need to follow the following process:

<aside> ⚠️ You may be forbidden to do it if you have already reached the limit of sandboxes or production domain. In that case, you will have the following message “You do not have sufficient rights to perform this action, refer to an administrator of your Workspace.” If for some reason you need to increase this limit, please talk to your CSM or send us an email at [email protected].

</aside>

Manage roles on the domain

Domain - Role management.gif