Skip to content

Team and roles

Invite teammates, choose the right role, and remove access when responsibilities change.

Give engineers access to integrations, finance teammates access to billing, and other teammates a read-only view. Roles apply within each organization, so the same person can have different responsibilities in different teams.

Roles

Owners manage everything, including members and roles. Developers manage API keys, service accounts and Subgraph resources, billing admins manage billing, and every role can read the dashboard and usage.
RoleBest for
OwnerTrusted administrators who manage team access, billing, and every resource.
DeveloperEngineers who operate integrations, API keys, service accounts, Managed Subgraphs, and Endpoint Aliases.
Billing adminFinance or operations teammates who manage the monthly plan, top-ups, automatic top-ups, payment, invoices, and alerts.
ViewerTeammates who need visibility without change access.

Each role is a set of permissions, one for each action with its own consequence. The platform, the GraphOps platform API, and service accounts use the same permissions. The last column shows whether a service account can hold each one. Person only permissions create or change credentials and service accounts, move money, or change who belongs to the organization, so only a signed-in person can use them. Before a person-only change, GraphOps asks you to sign in again if you have not signed in recently.

AreaPermissionOwnerDeveloperBilling adminViewerService account
OrganizationRead organization overviewYesYesYesYesYes
ServicesRead data servicesYesYesYesYesYes
UsageRead usageYesYesYesYesYes
SubgraphsRead SubgraphsYesYesYesYesYes
Run explorer queriesYesYesYesYesNo
SubstreamsRead Substreams packagesYesYesYesYesYes
Managed SubgraphsRead Managed SubgraphsYesYesYesYesYes
Create Managed SubgraphsYesYesNoNoYes
Rename Managed SubgraphsYesYesNoNoYes
Stage deploymentsYesYesNoNoYes
Cancel NextYesYesNoNoYes
Promote NextYesYesNoNoYes
Reconfigure Managed SubgraphsYesYesNoNoYes
Delete Managed SubgraphsYesYesNoNoYes
Endpoint AliasesRead Endpoint AliasesYesYesYesYesYes
Create Endpoint AliasesYesYesNoNoYes
Retarget Endpoint AliasesYesYesNoNoYes
Reconfigure Endpoint AliasesYesYesNoNoYes
Delete Endpoint AliasesYesYesNoNoYes
API keysRead API keysYesYesNoNoYes
Create query keysYesYesNoNoPerson only
Edit API key accessYesYesNoNoPerson only
Rotate API keysYesYesNoNoPerson only
Rename API keysYesYesNoNoYes
Revoke API keysYesYesNoNoYes
Service accountsRead service accountsYesYesNoNoYes
Create service accountsYesYesNoNoPerson only
Edit service accountsYesYesNoNoPerson only
Create service account keysYesYesNoNoPerson only
Delete service accountsYesYesNoNoPerson only
MembersRead membersYesNoNoNoYes
Change member rolesYesNoNoNoPerson only
Remove membersYesNoNoNoPerson only
InvitationsRead invitationsYesNoNoNoYes
Invite membersYesNoNoNoPerson only
Resend invitationsYesNoNoNoPerson only
Revoke invitationsYesNoNoNoPerson only
BillingRead billingYesNoYesNoYes
Make purchasesYesNoYesNoPerson only
Reduce and cancelYesNoYesNoPerson only
Change billing detailsYesNoYesNoPerson only
Change billing notificationsYesNoYesNoPerson only

Your role applies equally to the platform, direct API requests, and authenticated support reads. Every member can see usage and technical resources, plus the plan size, remaining credits, and active-key count on Overview.

Choose the narrowest role that covers each person's work. Custom roles and a separate admin role are not available: use the owner role for team administration and the billing admin role for payment responsibilities. The person who creates an organization becomes its owner.

Invite a teammate

An invitation stays pending for 7 days, and an owner can resend an expired one to reopen it for another 7 days. The recipient joins only by signing in with the invited email and accepting it; creating an account alone does not join the organization. Revoked and accepted links cannot be reused.
  1. As an Owner, open Organization → Invitations.
  2. Invite the teammate by email and choose the least-privileged role that matches their job. You can offer only a role whose permissions your own role includes, so only an owner can invite an owner.
  3. Tell the recipient which organization they are joining and which email you used.
  4. The recipient signs in with the invited email, verifies it if needed, and accepts the invitation. Creating an account alone does not accept it.

Check the email address before sending. If the role or recipient is wrong, revoke the pending invitation and send a new one; accepted and revoked invitation links cannot be reused.

If an invitation expires before the recipient accepts it, open the Archived tab and choose Resend from its row menu. The same invitation becomes pending again for another 7 days, and the recipient gets a new email. Resend is unavailable when a newer pending invitation already exists for that email.

Update or remove access

Owners can change roles or remove members from Organization → Members. Like an invitation, a role change never grants a role with permissions your own role lacks. Review access before sensitive work begins and whenever someone's responsibilities change.

When you remove someone who had access to API key secrets, rotate or revoke the keys they could have copied. Removing a member, or changing their role, does not change or revoke the keys or service accounts they created; Created by in API keys shows who created each key.

When your own role changes while the dashboard is open, the next refresh verifies your membership and updates the pages you can use. You remain in the organization; a page outside your new role returns to Overview.

Next steps

Last updated