Permissions
Everything someone can do in an organization comes down to the seat they hold, the role on that seat, and whether the work is in their scope.
Seats
| Owner | Everything. An organization can have several, and an owner can't be locked out. |
|---|
| Member | Works in the teams and projects they belong to, and administers nothing. |
|---|
| Viewer | Reads what's in their scope and changes nothing. Takes no paid seat. |
|---|
Roles
An organization can define roles such as "Design Lead" or "QA" in settings. A role is a named list of permissions, and it replaces a member's default access rather than adding to it: what's ticked is exactly what the person gets. Owners can also edit the default access of members who hold no role.
Only members carry roles. Doing anything to a subject also grants seeing it, so a role that can edit pages can always read them.
Scope
A permission says what someone may do, not where. Whether a project is visible to them, whether they're on the team that owns it, and whether the organization is locked for non-payment are checked separately, and both have to allow it.
Coding agents
A coding agent holds the permissions of the person who connected it and never more. If that person becomes a viewer or leaves, the agent's access changes with them.
Every permission
The defaults for each seat. Owners hold all of these.
Organization
| Permission | Member | Viewer |
|---|
Rename the organization and edit its details
organization.edit | – | – |
Delete the organization
organization.delete | – | – |
Export the organization's data
organization.export | – | – |
People
| Permission | Member | Viewer |
|---|
See who is in the organization
members.view | ✓ | ✓ |
Invite people
members.invite | – | – |
Change someone's role, title or reporting line
members.edit | – | – |
Remove people
members.remove | – | – |
Roles
| Permission | Member | Viewer |
|---|
See the roles and what they grant
roles.view | ✓ | ✓ |
Create roles
roles.create | – | – |
Edit a role's permissions
roles.edit | – | – |
Delete roles
roles.delete | – | – |
Job titles
| Permission | Member | Viewer |
|---|
Add job titles
positions.create | – | – |
Rename job titles
positions.edit | – | – |
Remove job titles
positions.delete | – | – |
Teams
| Permission | Member | Viewer |
|---|
See teams
teams.view | ✓ | ✓ |
Create teams
teams.create | – | – |
Rename teams and change their rosters
teams.edit | – | – |
Delete teams
teams.delete | – | – |
Projects
| Permission | Member | Viewer |
|---|
See projects
projects.view | ✓ | ✓ |
Create projects
projects.create | – | – |
Work in a project they belong to
projects.edit | ✓ | – |
Manage every project, including private ones
projects.manage | – | – |
Delete projects
projects.delete | – | – |
Boards
| Permission | Member | Viewer |
|---|
See boards
tickets.view | ✓ | ✓ |
Create tickets
tickets.create | ✓ | – |
Edit and move tickets
tickets.edit | ✓ | – |
Delete tickets and columns
tickets.delete | – | – |
Sprints
| Permission | Member | Viewer |
|---|
See sprints
sprints.view | ✓ | ✓ |
Create sprints
sprints.create | – | – |
Edit sprints and their project roster
sprints.edit | – | – |
Delete sprints
sprints.delete | – | – |
Pages
| Permission | Member | Viewer |
|---|
Read pages
pages.view | ✓ | ✓ |
Create pages
pages.create | ✓ | – |
Edit pages
pages.edit | ✓ | – |
Delete pages
pages.delete | ✓ | – |
Whiteboards
| Permission | Member | Viewer |
|---|
Open whiteboards
whiteboards.view | ✓ | ✓ |
Draw on whiteboards
whiteboards.edit | ✓ | – |
Chat
| Permission | Member | Viewer |
|---|
Read chat
chat.view | ✓ | ✓ |
Post in chat
chat.post | ✓ | – |
Delete anyone's messages
chat.moderate | – | – |
Bots
| Permission | Member | Viewer |
|---|
See the organization's bots
bots.view | ✓ | ✓ |
Create bots
bots.create | – | – |
Edit bots
bots.edit | – | – |
Delete bots
bots.delete | – | – |
Coding agents
| Permission | Member | Viewer |
|---|
See agent activity and keys
agents.view | ✓ | ✓ |
Connect a coding agent to the organization
agents.connect | ✓ | – |
Revoke anyone's agent key
agents.revoke | – | – |
Audit log
| Permission | Member | Viewer |
|---|
Read the audit log
audit.view | – | ✓ |
Integrations
| Permission | Member | Viewer |
|---|
See connected repositories
integrations.view | ✓ | ✓ |
Connect repositories, webhooks and API tokens
integrations.manage | – | – |