Roles & Permissions

Geog uses role-based access control (RBAC) to manage what members can do within an organization. Each member is assigned a role that determines their permissions.

Organization Roles

Every organization member has one of three roles:

RoleDescription
OwnerFull control over the organization, including billing, deletion, and all settings
AdminManage members, tokens, and organization settings — but cannot manage billing or delete the organization
MemberCreate and manage API tokens, view usage and billing information

Choosing a Role

  • Owner — Assign to the person responsible for billing and overall organization management. Every organization must have at least one owner.
  • Admin — Assign to team leads or technical administrators who need to manage members and settings.
  • Member — Assign to developers and analysts who need API access and usage visibility.

Permission Reference

Member Management

PermissionOwnerAdminMember
Invite members
Remove members
Change member roles
View members

Token Management

PermissionOwnerAdminMember
Create API tokens
Revoke API tokens
View tokens
Manage token settings (rate limits, scopes)

Usage & Analytics

PermissionOwnerAdminMember
View usage dashboard
Export usage data
View analytics

Billing

PermissionOwnerAdminMember
Manage billing & payment methods
Manage subscription
View billing information

Organization Settings

PermissionOwnerAdminMember
Update organization name & settings
Configure organization-level settings
Delete organization

Resources

PermissionOwnerAdminMember
View resources
Create, update, and delete resources

Common Questions

"Why can't I change billing settings?"

Only organization owners can manage billing, payment methods, and subscriptions. If you need billing access, ask an owner to either:

  • Change your role to owner, or
  • Make the billing changes on your behalf

"How do I invite a new team member?"

You need the owner or admin role to invite members. Go to your organization's Members page in the console, click Invite Member, and enter their email address. They'll receive an invitation email with a link to join.

"Can I be a member of multiple organizations?"

Yes. You can belong to multiple organizations and have a different role in each. Use the organization switcher in the console sidebar to switch between them.

"How do I change someone's role?"

Owners and admins can change roles from the Members page. Click the role dropdown next to a member's name and select the new role. Role changes take effect immediately.

"Can an admin promote themselves to owner?"

No. Only existing owners can assign the owner role. This prevents privilege escalation.

Changing Roles

  1. Navigate to your organization in the console
  2. Go to Members in the sidebar
  3. Find the member whose role you want to change
  4. Click the role dropdown next to their name
  5. Select the new role

Role changes take effect immediately across all sessions.

Next Steps