Skip to main content

Project permissions

Project permissions decide who can work on a project in the console, CLI, API and MCP: deploy it, change its settings, edit its data, transfer it or delete it. Every project route asks one shared check, so the console, the API and the audit log always agree.

Relationships to a project​

A person's relationship to a project is the strongest that applies, in this order:

RelationshipHow you get itViewManageOwn
OwnerYou created the project, or it was transferred to you✓✓✓
Org AdminHub role✓✓✓
Delegated AdminHub role whose scope covers the owner✓✓✓
DeveloperThe project's developer app role, directly or through a group✓✓
AuditorHub role✓
Anyone elseThe project doesn't exist for them (404)

Manage covers deploys, promote, rollback and redeploy, environment variables, access settings, Database Studio writes, storage writes, integration requests and revokes, and running scheduled jobs.

Own covers transfer, renew, archive and restore, and delete.

note

Storage quotas are the one exception: only Org Admins change them.

What people see​

  • GET /api/projects/<name> returns a perms object, and the console disables actions the caller can't take, with a tooltip explaining why.
  • Admins acting on someone else's project see a banner, and their changes are audited with their role.
  • Auditors see a read-only banner. Environment variables show names without values, and the SQL editor is read-only.
  • Developers who try an owner-only action get "Only the owner or an admin can do that."

Projects home​

The console's projects home has tabs that match your role:

Your roleTabs
EveryoneMine
Org AdminAll
Delegated AdminIn my scope
AuditorAll (read-only)

Project developers​

Give someone the developer app role on the project's Access page to let them deploy and change settings without making them the owner. Developers can't transfer, renew, archive or delete the project.

tip

Use a directory group for the developer role (for example "Finance Apps Team") so people who join the team get access without editing the project.

Was this page helpful?