Roles & Permissions
How organization and project roles control what members can see and do.
Tektona access is organized in two levels: an organization contains projects, and each member's role decides what they can see and do.
Organization roles
Every member of an organization has one org role.
| Role | What you can do |
|---|---|
| Member | See the organization and its projects, and the access your project roles grant. |
| Admin | Everything a member can, plus add and remove members (at the Member role). |
| Owner | Full control: manage all members and roles, change organization settings, and delete the organization. Owners automatically have Admin access on every project. |
Only an owner can change organization settings or remove other owners, and an organization must always keep at least one owner.
A service account holds roles like a member. It is never an owner. An organization service account gets the default project role, like a member. It cannot create a project or an organization.
Anyone with a Tektona account can create a new organization and becomes its owner. Renaming or otherwise updating an organization requires the Owner role; updating a project requires project Admin. All of this works from the console or the CLI (see Organizations & projects).
Who can create projects
Owners and Admins can always create a project. A Member can create one when the organization setting Allow members to create projects is on. It is on by default. The creator of a project becomes that project's Admin.
A project Admin can use org secrets in project egress proxy profile rules, and a rule can send the value to any host it names. If your organization does not trust every member with its org secrets, an owner turns this setting off in organization settings.
Add members
You add a person who signed in to Tektona at least once. In the console, search by name or handle. The search and the add find people who sign in through the same tenant as you, and people who already share an organization with you. For any other person, the add reports that no user was found.
Project roles
Within a project, each member has one project role. Owner is an organization concept. The top project role is Admin.
| What you can do | Reader | Writer | Admin |
|---|---|---|---|
| View the project, its repositories, and settings | ✅ | ✅ | ✅ |
| View (read-only) a sandbox shared with you | ✅ | ✅ | ✅ |
| Create and manage repositories | ❌ | ✅ | ✅ |
| Create sandboxes (you become the owner) | ❌ | ✅ | ✅ |
| Operate sandboxes you own or that are shared with you | ❌ | ✅ | ✅ |
| Use a project or org secret / egress proxy profile when creating a sandbox (without seeing its value) | ❌ | ✅ | ✅ |
| Manage your own personal secrets (incl. git credentials) | ❌ | ✅ | ✅ |
| Operate, delete, or expose any sandbox in the project | ❌ | ❌ | ✅ |
| Manage project secrets, egress proxy profiles & security: shared secrets/git credentials, container registries, egress network policies | ❌ | ❌ | ✅ |
| Change project settings and manage project members | ❌ | ❌ | ✅ |
| Delete the project | ❌ | ❌ | ✅ |
A project's member list shows everyone who can open the project. Organization owners appear as Admin, marked Org owner. Organization members who get access from the default project role appear with that role, marked Org default. You change these two kinds of access on the organization, not on the project.
Secrets & egress proxy profiles
Secrets and Egress Proxy Profiles exist at three scopes, and who manages them follows the scope:
| Scope | Who manages it | Who can use it |
|---|---|---|
| Organization | org Owners and Admins (in organization settings) | every project in the org |
| Project | project Admins | anyone who can create a sandbox in the project (Writer+) |
| Personal | you (Writer or Admin) | only sandboxes you own |
Managing is not the same as using. Creating a sandbox that uses a project or org secret needs only Writer. The value is injected at the network edge and never shown, so a Writer can run a sandbox with the team's Anthropic key without being able to read or change it. Only Admins/Owners (per the policy below) can create, edit, or delete the shared secrets and profiles themselves. Values are write-only everywhere: managing a secret means setting or replacing it, never reading it back.
Restricting who can manage
Managing project secrets and egress proxy profiles always requires Admin. Writers can use them but never create, edit, or delete them. Admin is a fixed floor, not something a project can lower.
An organization owner can configure the governance around that:
- Allow members to create projects. On by default. A project Admin can use org secrets in project rules, so turn it off when you do not trust every member with org secrets. See Who can create projects.
- Allow personal secrets. On by default. Turn it off to require every credential to go through managed org or project secrets (for compliance). Turning this off does not delete existing personal secrets. They simply stop resolving (they are no longer injected), so a sandbox that relied on one falls back to the project or org scope, or fails closed if no shared value covers it.
Sandbox ownership
Sandboxes are not visible to everyone in a project by role alone. Each sandbox is owned by one user and private by default, so only its owner and project or org admins can see or operate it. Owners share a sandbox explicitly to let project members use it (and let readers observe it), and ownership can be transferred. Deleting or exposing a sandbox you don't own requires Admin (or owning it).
See Sharing Sandboxes for how sharing, transfer, and the admin oversight commands work.
Default project role
When someone joins your organization, they get a default role on its projects, the default project role, set by an organization owner. It can be:
- None. No access to projects unless added to one explicitly (good for keeping projects private by default).
- Reader, Writer, or Admin, the access every org member gets on projects automatically.
You can always grant an individual member a different role on a specific project, and an explicit project role overrides the default.
Outside collaborators
You can add someone to a single project without making them a member of your organization. They see only the project they were added to, with the project role you give them.
When someone leaves your organization, or you remove them, they lose their roles on all of its projects. To keep them on one project, add them back to it as an outside collaborator.