Skip to main content
Everything in Mesa lives inside an organization. Repositories, API keys, webhooks, and members are all scoped to a single org. You can belong to multiple orgs and switch between them from the dashboard.

​
Organizations

An organization has a display name and a slug. The slug is the URL-friendly identifier used in API paths and git URLs (e.g. api.mesa.dev/{slug}/repo).

​
Creating an organization

Your first organization is created during sign-up, or you join one by accepting an invitation. If you haven’t done this yet, see Quickstart. To create additional organizations, use the org switcher dropdown in the dashboard sidebar. The creator automatically becomes the owner. Slug rules:
  • Lowercase letters, numbers, and hyphens only
  • Cannot start or end with a hyphen
  • Must be unique across all Mesa orgs

​
Organization settings

From Settings in the sidebar you can update the display name and see org-level stats (members, repositories, API tokens).

​
Deleting an organization

Only owners can delete an organization. Deletion is permanent and cascades to all repositories, API keys, members, and invitations.

​
API access

Organization identity is available via the API:
  • GET /whoami — returns the org tied to the calling API key, effective scopes, and key metadata
  • GET /{org} — returns org details by slug
Both require the read scope. All other org management (create, update, delete) is dashboard-only.

​
Roles

Every member has a role that determines what they can do within the org.
OwnerAdminMember
Create, update, delete reposYesYesYes
Push, create bookmarks, create changesYesYesYes
Clone, fetch, read contentYesYesYes
Create API keysYes, up to admin scopeYes, up to admin scopeYes, up to write scope only
Manage webhooksYesYesNo
Invite and remove membersYesYesNo
View member listYesYesYes
Update org name and slugYesYesNo
Delete orgYesNoNo
Roles are assigned when a member is invited. There is no way to change a member’s role after they join — remove and re-invite with the correct role instead.

​
Members

View and manage members from the Members page in the dashboard sidebar.

​
Inviting members

Click Invite member to send an email invitation. You choose the role (member or admin) at invite time. Inviting requires the admin role.
  • Invitations expire after 48 hours
  • Re-inviting the same email refreshes the existing invitation
  • The invitee must use the same email address to accept

​
Pending invitations

Pending invitations appear below the member list. Admins and owners can cancel a pending invitation from the overflow menu.

​
Removing members

Admins and owners can remove members. The org owner cannot be removed.