---
title: "Roles"
url: https://docs.corefinity.com/guides/organisation/people/roles
type: guide
last_updated: 2026-11-13
feature: team
related:
  - https://docs.corefinity.com/api/reference/organisation/get-own-company.md
  - https://docs.corefinity.com/api/reference/organisation/update-company-settings.md
  - https://docs.corefinity.com/api/reference/organisation/get-company-details.md
  - https://docs.corefinity.com/api/reference/organisation/list-own-permissions.md
  - https://docs.corefinity.com/api/reference/organisation/list-assignable-roles.md
  - https://docs.corefinity.com/api/reference/organisation/attach-role-to-user.md
  - https://docs.corefinity.com/mcp/tools/corestack_team_members_list.md
  - https://docs.corefinity.com/mcp/tools/corestack_team_member_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_team_member_invite.md
  - https://docs.corefinity.com/mcp/tools/corestack_team_member_invite_resend.md
  - https://docs.corefinity.com/mcp/tools/corestack_team_member_update.md
  - https://docs.corefinity.com/mcp/tools/corestack_team_member_remove.md
---
# Roles

See the roles your organisation can give its users and what each role may do.

## Before you start

- Every user of the organisation can open **Roles**.
- A role is a set of permissions. Each user holds a role, chosen when they are invited.
- Built-in roles cannot be changed or deleted. To choose the permissions yourself, see [Custom roles and permissions](/guides/organisation/people/custom-roles-and-permissions).

## See what a role may do

1. **Open Roles**

   Go to **Organisation › Roles**. The list shows each role with its number of **Permissions** and **Users**.

   _Screenshot: The Roles page with Roles ringed under Organisation in the menu: the custom role Content editor and the built-in roles Accounts & Billing, Member (Limited Access), Member (Full Access) and Owner, each with its permissions and users, and the Create role button._

2. **Open a role**

   Choose a role's name. **Permissions** lists every permission by area, with a tick on each one the role holds.

   _Screenshot: The page of the role Member (Limited Access): 24 of 74 permissions, and the Permissions card with a search box, the Category and Granted filters, and the permissions of each area with a tick or a dash._

3. **Find a permission**

   Enter a word in **Search permissions**, or choose **Granted**, then **Granted only**, to hide what the role does not hold. **Users with this role** lists who holds it.

To list one kind of role, choose **Scope**, then **Built-in** or **Custom**.

## Built-in roles

An organisation has these roles:

| Role                        | May                                                                                                                                        |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Owner**                   | Do everything, including open Billing, create roles, make a user an owner and disconnect a repository account.                             |
| **Member (Full Access)**    | Run deployments, edit the pipeline, and manage users, custom roles, organisation SSH keys and repository connections. Cannot open Billing. |
| **Member (Limited Access)** | See deployments and the pipeline without starting or changing them.                                                                        |
| **Accounts & Billing**      | Open Billing, and manage users, custom roles, organisation SSH keys and repository connections. Sees deployments without starting them.    |

An agency has these roles instead:

| Role                           | May                                                                                                                                |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Owner**                      | Do everything, as an organisation's **Owner**.                                                                                     |
| **Accounts / Project Manager** | The same as **Member (Full Access)**.                                                                                              |
| **Senior Developer**           | Run deployments, edit the pipeline, and manage organisation SSH keys and repository connections. Sees users without changing them. |
| **Junior Developer**           | The same as **Member (Limited Access)**.                                                                                           |
| **Accounts & Billing**         | The same as an organisation's **Accounts & Billing**.                                                                              |

A role does not limit the rest of a site: every user who can open a site can change its settings.

## Automate this

**API:** [List the roles you may give](https://docs.corefinity.com/api/reference/organisation/list-assignable-roles.md), scope `read`

```bash
curl https://manage.corefinity.com/api/roles \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
```

**MCP:** [`corestack_team_roles_list`](https://docs.corefinity.com/mcp/tools/corestack_team_roles_list.md), scope `read`

```json
{
  "name": "corestack_team_roles_list",
  "arguments": {}
}
```

**Control Panel:** Organisation › Users ([https://manage.corefinity.com/go/team](https://manage.corefinity.com/go/team))

## Related

- [Custom roles and permissions](/guides/organisation/people/custom-roles-and-permissions): Create a role and choose its permissions.
- [Users and invitations](/guides/organisation/people/users-and-invitations): Invite a user and choose their role.
- [Require two-factor](/guides/organisation/people/require-two-factor): Ask every user for a second factor.
