Organizations

Organizations let you group users into teams with role-based access control. Tenants are owned by organizations, so multiple team members can manage push notifications together.

What This Is

An organization is a container for users and tenants. When you create a tenant for push notifications, it belongs to an organization. Members of that organization can then manage the tenant based on their role.

When to Use

• You have multiple people who need access to your app's push notifications
• You want to separate concerns (e.g., one org per app)
• You need role-based access control for team members

Roles

Role	Permissions
owner	Full access. Can delete the organization. Only one owner per org.
admin	Can manage members, create/delete tenants, send notifications.
member	Can view org details, list tenants, send notifications to existing tenants.

Creating an Organization

Use the CLI:

mushu org create "My Team"

Or the API:

POST /orgs
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "name": "My Team"
}

The user who creates the organization becomes its owner.

Managing Members

List Members

mushu org members list ORG_ID

Add a Member

You need the user's ID (they must have signed in at least once):

mushu org members add ORG_ID USER_ID --role member

Update Role

mushu org members update ORG_ID USER_ID admin

Remove Member

mushu org members remove ORG_ID USER_ID

Viewing Your Membership

See which organizations you belong to:

mushu org list

Check your role in a specific org:

mushu org members me ORG_ID

Deleting an Organization

Only the owner can delete an organization. This also deletes all tenants.

mushu org delete ORG_ID

FAQ

Can a user belong to multiple organizations?

Yes. A user can be a member of any number of organizations with different roles in each.

How do I transfer ownership?

Currently, ownership cannot be transferred. The owner would need to make another user an admin and coordinate access. Contact support if you need to transfer ownership.

Can I have multiple owners?

No. Each organization has exactly one owner. Use the admin role for users who need full management access.

What happens when I leave an organization?

You lose access to all tenants in that organization. If you're the owner, you cannot leave—you must delete the organization or transfer ownership.