Manage Your Organization

Organizations are the primary unit of multi-tenancy in the Developer Portal. Each organization maps to a developer identity in the Provider Portal. All applications, subscriptions, and credentials belong to an organization.

note

The organization model is specific to the default Developer Portal implementation using Better Auth. If your portal has a custom implementation, organization management may differ or not be present.

Organization Roles

Each organization member has one of three roles:

Role	Permissions
Owner	Full access. Can manage members, update organization settings, and perform all actions.
Admin	Same permissions as owner. Can manage members and settings.
Member	Read-only access. Can view applications, subscriptions, and credentials but cannot create or modify them.

Invite Members

Organization owners and admins can invite new members:

1. Navigate to your organization's Settings or Members page.
2. Click Invite Member.
3. Enter the email address of the person you want to invite.
4. Select a role (Admin or Member).
5. Click Send Invitation.

The invited person receives an email with instructions to join the organization. If they do not have a Developer Portal account, they will need to register first.

Manage Members

View Members

Navigate to the organization Members page to see all current members with their roles and join dates.

Change a Member's Role

1. Find the member in the members list.
2. Click their role or the Edit button.
3. Select the new role.
4. Confirm the change.

Remove a Member

1. Find the member in the members list.
2. Click Remove (or the delete icon).
3. Confirm the removal.

Removing a member revokes their access to the organization's applications, subscriptions, and credentials.

Switch Between Organizations

If you belong to multiple organizations:

1. Click the organization switcher in the portal navigation (typically in the header or sidebar).
2. Select the organization you want to switch to.
3. The portal context updates to show the selected organization's applications and subscriptions.

Create a New Organization

If you need a separate context for a different project or team:

1. Click the organization switcher.
2. Click Create Organization.
3. Enter an Organization Name and Slug URL.
4. Click Create.

The new organization creates a new developer identity in the Provider Portal.

Organization Settings

Organization owners and admins can update:

• Organization name: The display name of the organization.
• Logo: The organization's avatar or logo.

Additional Resources

• Developers
• Create an Application
• Register and Log In