> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/users-roles-and-permissions/roles-and-permissions-summary.md).

# Roles & permissions summary

### Introduction

Every user in your company profile is given a role. Your role decides what you can see and do in the Patchworks dashboard and through the Patchworks API. This page lists every permission you can be given in Patchworks, what it lets you do, and which roles have it.

> **Looking for how to do something?** Use the [permissions finder](https://doc.wearepatchworks.com/product-documentation/users-roles-and-permissions/roles-and-permissions-summary/permissions-finder.md) to look up a task in plain words, such as *run a process flow* or *download a payload*, and see which roles can do it.

There are four standard roles:

| Role              | Summary                                                                                                                                                                                |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Administrator** | Full control of your company profile, including company admin, SSO, private marketplaces and assigning roles.                                                                          |
| **Manager**       | Builds and runs integrations: process flows, connectors, virtual environments, scripts, lookups and users.                                                                             |
| **User**          | Views everything, and can manage connectors, credentials, caches, notification groups, usage alerts, message brokers and connection pools. Cannot create, change or run process flows. |
| **Read-only**     | Views and searches everything, but cannot change anything.                                                                                                                             |

Roles build on each other: a manager has every user and read-only permission, and an administrator has every manager permission.

> **Tier trumps role.** A role gives you permission to use a feature, but the feature is only available if your [subscription tier](https://doc.wearepatchworks.com/product-documentation/getting-started/subscription-tier-limits) includes it. For example, a manager on a Standard tier has read-only access to custom scripts, while a manager on a Professional tier has full access.

> **Permissions apply to your own company profile.** If you manage several companies, see [multi-company profiles](https://doc.wearepatchworks.com/product-documentation/company-management/multi-company-profiles).

> **Roles control create, read, update and delete access.** Process flow setup and runs are not tied to a specific user.

### Bolt-on roles

Bolt-on roles can be added to any user on top of their standard role, to give extra permissions without changing their main role.

| Bolt-on role   | What it adds                                                              | Included with                     |
| -------------- | ------------------------------------------------------------------------- | --------------------------------- |
| **SSO admin**  | View, create, update and delete SSO (OIDC) configuration, and bypass SSO. | Administrator                     |
| **Bypass SSO** | Sign in with a username and password when SSO is enforced.                | Administrator (through SSO admin) |
| **AI Studio**  | Access to AI Studio.                                                      | Available on request.             |

### How are roles assigned to users?

The person who registers your company account is given the administrator role. Administrators can then [create users](https://doc.wearepatchworks.com/product-documentation/users-roles-and-permissions/creating-a-new-user-account-for-your-company-profile) and [update their roles](https://doc.wearepatchworks.com/product-documentation/users-roles-and-permissions/updating-the-role-for-an-existing-user-account).

> Most organisations have one administrator. If you need more than one, please [raise a support ticket](https://doc.wearepatchworks.com/product-documentation/raising-a-support-ticket).

### Permissions by area

**Key:** A = administrator, M = manager, U = user, R = read-only, PS = Patchworks support. The **Permission** column shows the internal permission name, which you may see in audit logs or API error messages.

#### Company profile

Your company profile holds your company name, contact details and banner messages.

| Task                                       | What it lets you do                                                             | Allowed roles | Permission                 |
| ------------------------------------------ | ------------------------------------------------------------------------------- | ------------- | -------------------------- |
| View company profile                       | See your own company profile.                                                   | A, M, U, R    | `read owned companies`     |
| Search own companies                       | List the company profiles your account belongs to.                              | A, M, U, R    | `search owned companies`   |
| Update company profile contact information | Edit contact details held on your company profile.                              | A, M          | `update companies`         |
| Update company profile name                | Change the name of your company profile.                                        | A             | `rename company`           |
| Add & manage banner messages               | Create, edit and remove banner messages shown to users of your company profile. | A             | `manage company banners`   |
| View enabled features                      | See which platform features are switched on for your company.                   | A, M, U, R    | `search tenanted features` |
| View subscription tiers                    | Open and see the details of subscription tiers and what each one includes.      | A, M, U, R    | `read tiers`               |
| Search & list subscription tiers           | List, filter and search subscription tiers and what each one includes.          | A, M, U, R    | `search tiers`             |

#### Company admin

Company admin options are reserved for administrators.

| Task                              | What it lets you do                                                                                     | Allowed roles | Permission                 |
| --------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------- | -------------------------- |
| View/access company admin options | Open the company admin area of settings.                                                                | A             | `manage company-admin`     |
| Create company databases          | Provision a dedicated database for your company (used by features such as data reporting).              | A, M          | `create company-databases` |
| Create BI user                    | Create a read-only business intelligence (BI) user so reporting tools can connect to your company data. | A, M          | `create bi-user`           |
| Delete BI user                    | Remove the BI reporting user.                                                                           | A, M          | `delete bi-user`           |

#### Single sign-on (SSO)

SSO settings let you sign in to Patchworks through your own identity provider using OpenID Connect (OIDC). Administrators get these permissions automatically. They can also be given as bolt-on roles.

| Task                            | What it lets you do                                                                                                                                                   | Allowed roles                            | Permission    |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------- |
| View SSO (OIDC) configuration   | Open the SSO (OIDC) configuration page and see the OpenID Connect configuration used for single sign-on.                                                              | A, SSO admin bolt-on                     | `view oidc`   |
| Create SSO (OIDC) configuration | Add new OpenID Connect configuration used for single sign-on.                                                                                                         | A, SSO admin bolt-on                     | `create oidc` |
| Update SSO (OIDC) configuration | Edit existing OpenID Connect configuration used for single sign-on.                                                                                                   | A, SSO admin bolt-on                     | `update oidc` |
| Delete SSO (OIDC) configuration | Permanently remove the OpenID Connect configuration used for single sign-on.                                                                                          | A, SSO admin bolt-on                     | `delete oidc` |
| Bypass SSO                      | Sign in with a Patchworks username and password even when SSO is enforced for your company. Useful as a break-glass account if your identity provider is unavailable. | A, SSO admin bolt-on, Bypass SSO bolt-on | `bypass sso`  |

#### Company users

Company users are the people who can sign in to your company profile.

| Task                        | What it lets you do                                                     | Allowed roles | Permission             |
| --------------------------- | ----------------------------------------------------------------------- | ------------- | ---------------------- |
| View users                  | Open and see the details of user accounts.                              | A, M, U, R    | `read users`           |
| Search & list users         | List, filter and search user accounts.                                  | A, M, U, R    | `search users`         |
| Create users                | Add new user accounts.                                                  | A, M          | `create users`         |
| Update users                | Edit existing user accounts.                                            | A, M          | `update users`         |
| Delete users                | Permanently remove user accounts.                                       | A, M          | `delete users`         |
| View company users          | Open and see the details of the users attached to your company profile. | A, M, U, R    | `read company users`   |
| Search & list company users | List, filter and search the users attached to your company profile.     | A, M, U, R    | `search company users` |
| Create company users        | Add new users attached to your company profile.                         | A, M          | `create company users` |
| Update company users        | Edit existing users attached to your company profile.                   | A, M          | `update company users` |
| Delete company users        | Permanently remove the users attached to your company profile.          | A, M          | `delete company users` |
| View roles                  | Open and see the details of the roles available to assign to users.     | A, M          | `read roles`           |
| Search & list roles         | List, filter and search the roles available to assign to users.         | A, M          | `search roles`         |
| List assignable roles       | See the roles you can choose from when creating or updating a user.     | A, M, U, R    | `search client roles`  |
| Manage roles                | Assign and change the roles held by users in your company.              | A             | `manage roles`         |

**Role assignment rules**

As well as the permissions above, these rules control which roles you can give to other users.

| Task                                                  | Allowed roles |
| ----------------------------------------------------- | ------------- |
| Create a company user with the administrator role     | PS            |
| Create a company user with the manager role           | A             |
| Create a company user with the user or read-only role | A, M          |
| Elevate a read-only account to user                   | A, M          |
| Elevate a user or read-only account to manager        | A             |
| Elevate any account to administrator                  | PS            |
| Demote a manager to user or read-only                 | A, M          |
| Demote another administrator                          | PS            |
| Trigger a password reset for a company user           | A, M          |
| Update own user details                               | A, M          |
| Enable/disable own MFA                                | A, M, U, R    |
| Elevate or reduce own role                            | Nobody        |

#### Linked companies

These permissions apply if you manage more than one company through a [multi-company profile](https://doc.wearepatchworks.com/product-documentation/company-management/multi-company-profiles).

| Task                                          | What it lets you do                                                                           | Allowed roles | Permission                          |
| --------------------------------------------- | --------------------------------------------------------------------------------------------- | ------------- | ----------------------------------- |
| View linked companies                         | See the companies linked to your multi-company profile.                                       | A, M          | `view managed companies`            |
| Switch in & out of linked companies           | Move between your own company and a linked company you manage.                                | A, M          | `switch managed companies`          |
| View team members who manage a linked company | See which of your team members can access each linked company.                                | A, M          | `view managed-users`                |
| View team member access                       | Open the team member access page and see access for a team member to manage a linked company. | A, M          | `view user-company`                 |
| Create team member access                     | Add new access for a team member to manage a linked company.                                  | A, M          | `create user-company`               |
| Remove team member access                     | Remove access for a team member to manage a linked company.                                   | A, M          | `destroy user-company`              |
| Duplicate process flows between companies     | Copy a process flow from one linked company to another.                                       | A, M          | `duplicate flows between companies` |

#### Company insights

Company insights show usage and activity for your company.

| Task                       | What it lets you do                                                                         | Allowed roles | Permission                 |
| -------------------------- | ------------------------------------------------------------------------------------------- | ------------- | -------------------------- |
| View transactions widget   | See the transactions usage widget on the dashboard.                                         | A, M          | `view transactions-widget` |
| View usage alerts          | Open and see the details of usage alerts that notify you when you approach your allowances. | A, M, U, R    | `read alerts`              |
| Search & list usage alerts | List, filter and search usage alerts that notify you when you approach your allowances.     | A, M, U, R    | `search alerts`            |
| Create usage alerts        | Add new usage alerts that notify you when you approach your allowances.                     | A, M, U       | `create alerts`            |
| Update usage alerts        | Edit existing usage alerts that notify you when you approach your allowances.               | A, M, U       | `update alerts`            |
| Delete usage alerts        | Permanently remove usage alerts that notify you when you approach your allowances.          | A, M, U       | `delete alerts`            |

#### Marketplace

The Patchworks marketplace is where you browse and install blueprints, connectors, process flow templates, scripts and cross-reference lookups.

| Task                                              | What it lets you do                                                               | Allowed roles | Permission                                |
| ------------------------------------------------- | --------------------------------------------------------------------------------- | ------------- | ----------------------------------------- |
| Browse & view marketplace connectors              | Open the marketplace and browse available connectors.                             | A, M, U, R    | `view connector marketplace`              |
| View process flow templates                       | Open and see the details of process flow templates in the marketplace.            | A, M, U, R    | `read flow-templates`                     |
| Create process flow templates                     | Add new process flow templates in the marketplace.                                | A, M, U       | `create flow-templates`                   |
| Update process flow templates                     | Edit existing process flow templates in the marketplace.                          | A, M, U       | `update flow-templates`                   |
| Install marketplace process flows                 | Install a process flow template from the marketplace into your company.           | A, M, U       | `install flow-templates`                  |
| View marketplace scripts                          | Open and see the details of scripts published in the marketplace.                 | A, M, U, R    | `read script-templates`                   |
| Search & list marketplace scripts                 | List, filter and search scripts published in the marketplace.                     | A, M, U, R    | `search script-templates`                 |
| Install marketplace scripts                       | Install a marketplace script into your company so it can be used in flows.        | A, M          | `install script-templates`                |
| View marketplace cross-reference lookups          | Open and see the details of cross-reference lookups published in the marketplace. | A, M, U, R    | `read cross-reference-lookup-templates`   |
| Search & list marketplace cross-reference lookups | List, filter and search cross-reference lookups published in the marketplace.     | A, M, U, R    | `search cross-reference-lookup-templates` |

#### Blueprints

Blueprints (known in the platform as marketplace apps) package connectors, process flows, scripts and lookups together so they can be installed in one go.

| Task                           | What it lets you do                                             | Allowed roles | Permission                 |
| ------------------------------ | --------------------------------------------------------------- | ------------- | -------------------------- |
| View blueprints                | Open and see the details of blueprints (marketplace apps).      | A, M, U, R    | `read marketplace-apps`    |
| Search & list blueprints       | List, filter and search blueprints (marketplace apps).          | A, M, U, R    | `search marketplace-apps`  |
| Install marketplace blueprints | Install a blueprint and all of its resources into your company. | A, M          | `install marketplace-apps` |

#### Private marketplaces

A [private marketplace](https://doc.wearepatchworks.com/product-documentation/marketplace/private-marketplaces) lets you publish your own blueprints and resources for your own companies to install.

| Task                                                  | What it lets you do                                             | Allowed roles | Permission                               |
| ----------------------------------------------------- | --------------------------------------------------------------- | ------------- | ---------------------------------------- |
| Create private blueprints                             | Add new blueprints in your private marketplace.                 | A             | `create private-marketplace-apps`        |
| Update private blueprints                             | Edit existing blueprints in your private marketplace.           | A             | `update private-marketplace-apps`        |
| Delete private blueprints                             | Permanently remove blueprints in your private marketplace.      | A             | `delete private-marketplace-apps`        |
| Upload connectors to private marketplace              | Publish a connector you have built to your private marketplace. | A             | `upload private-core-systems`            |
| Upload process flows to private marketplace           | Publish a process flow to your private marketplace.             | A             | `upload private-core-process-flows`      |
| Upload scripts to private marketplace                 | Publish a custom script to your private marketplace.            | A             | `upload private-core-scripts`            |
| Upload cross-reference lookups to private marketplace | Publish a cross-reference lookup to your private marketplace.   | A             | `upload private-cross-reference-lookups` |

#### Connectors and connector instances

A connector is an installed integration with a third-party system. A connector instance holds the credentials and settings for one connection to that system.

| Task                                   | What it lets you do                                                                        | Allowed roles | Permission               |
| -------------------------------------- | ------------------------------------------------------------------------------------------ | ------------- | ------------------------ |
| View installed connectors              | Open and see the details of connectors installed in your company.                          | A, M, U, R    | `read connectors`        |
| Search & list installed connectors     | List, filter and search connectors installed in your company.                              | A, M, U, R    | `search connectors`      |
| Create installed connectors            | Add new connectors installed in your company.                                              | A, M, U       | `create connectors`      |
| Update installed connectors            | Edit existing connectors installed in your company.                                        | A, M, U       | `update connectors`      |
| Delete installed connectors            | Permanently remove connectors installed in your company.                                   | A, M          | `delete connectors`      |
| Create connectors (connector settings) | Add new settings of an installed connector.                                                | A, M          | `create core-connectors` |
| Update connectors (connector settings) | Edit existing settings of an installed connector.                                          | A, M          | `update core-connectors` |
| Create connector instances             | Add new connector instances and their settings.                                            | A, M          | `create core-instances`  |
| Update connector instances             | Edit existing connector instances and their settings.                                      | A, M          | `update core-instances`  |
| View credentials                       | Open and see the details of credentials stored against a connector instance.               | A, M, U, R    | `read credentials`       |
| Search & list credentials              | List, filter and search credentials stored against a connector instance.                   | A, M, U, R    | `search credentials`     |
| Create credentials                     | Add new credentials stored against a connector instance.                                   | A, M, U       | `create credentials`     |
| Update credentials                     | Edit existing credentials stored against a connector instance.                             | A, M, U       | `update credentials`     |
| Delete credentials                     | Permanently remove credentials stored against a connector instance.                        | A, M, U       | `delete credentials`     |
| View OAuth clients                     | Open and see the details of OAuth client details used to authenticate connector instances. | A, M, U, R    | `read oauth-clients`     |
| Search & list OAuth clients            | List, filter and search OAuth client details used to authenticate connector instances.     | A, M, U, R    | `search oauth-clients`   |
| Create OAuth clients                   | Add new OAuth client details used to authenticate connector instances.                     | A, M, U       | `create oauth-clients`   |
| Update OAuth clients                   | Edit existing OAuth client details used to authenticate connector instances.               | A, M, U       | `update oauth-clients`   |
| Delete OAuth clients                   | Permanently remove OAuth client details used to authenticate connector instances.          | A, M, U       | `delete oauth-clients`   |

#### Connection pools

Connection pools control how many simultaneous connections Patchworks opens to a system, so you do not overload a third-party API.

| Task                         | What it lets you do                                             | Allowed roles | Permission                  |
| ---------------------------- | --------------------------------------------------------------- | ------------- | --------------------------- |
| View connection pools        | See every connection pool set up for your company.              | A, M, U       | `view all connection pools` |
| View connection pool details | See the settings and current usage of a single connection pool. | A, M, U       | `view connection pool`      |
| Create connection pools      | Add a new connection pool.                                      | A, M, U       | `create connection pool`    |
| Update connection pools      | Change the limits and settings of a connection pool.            | A, M, U       | `update connection pool`    |
| Delete connection pools      | Remove a connection pool.                                       | A, M, U       | `delete connection pool`    |
| Clear connection pools       | Release all connections currently held in a pool.               | A, M, U       | `clear connection pool`     |

#### Connector builder

The connector builder is used to build your own connectors: the system definition, how it authenticates, and the endpoints it exposes.

| Task                                 | What it lets you do                                                                                                 | Allowed roles | Permission                              |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | ------------- | --------------------------------------- |
| View connector definitions           | Open and see the details of connectors built in the connector builder.                                              | A, M, U, R    | `read core-systems`                     |
| Search & list connector definitions  | List, filter and search connectors built in the connector builder.                                                  | A, M, U, R    | `search core-systems`                   |
| Create connector definitions         | Add new connectors built in the connector builder.                                                                  | A, M          | `create core-systems`                   |
| Update connector definitions         | Edit existing connectors built in the connector builder.                                                            | A, M          | `update core-systems`                   |
| Delete connector definitions         | Permanently remove connectors built in the connector builder.                                                       | A, M          | `delete core-systems`                   |
| View authentication types            | Open and see the details of the authentication types available to connectors (for example OAuth 2.0 or basic auth). | A, M, U, R    | `read authentication-types`             |
| Search & list authentication types   | List, filter and search the authentication types available to connectors (for example OAuth 2.0 or basic auth).     | A, M, U, R    | `search authentication-types`           |
| View authentication methods          | Open and see the details of the authentication methods configured for a connector.                                  | A, M, U, R    | `read authentication-implementations`   |
| Search & list authentication methods | List, filter and search the authentication methods configured for a connector.                                      | A, M, U, R    | `search authentication-implementations` |
| Create authentication methods        | Add new authentication methods configured for a connector.                                                          | A, M          | `create authentication-implementations` |
| Update authentication methods        | Edit existing authentication methods configured for a connector.                                                    | A, M          | `update authentication-implementations` |
| Delete authentication methods        | Permanently remove the authentication methods configured for a connector.                                           | A, M          | `delete authentication-implementations` |
| View endpoints                       | Open and see the details of the endpoints defined for a connector.                                                  | A, M, U, R    | `read endpoints`                        |
| Search & list endpoints              | List, filter and search the endpoints defined for a connector.                                                      | A, M, U, R    | `search endpoints`                      |
| Create endpoints                     | Add new endpoints defined for a connector.                                                                          | A, M          | `create endpoints`                      |
| Update endpoints                     | Edit existing endpoints defined for a connector.                                                                    | A, M          | `update endpoints`                      |
| Delete endpoints                     | Permanently remove the endpoints defined for a connector.                                                           | A, M          | `delete endpoints`                      |
| View endpoint parameters             | Open and see the details of parameters (query, path and header) defined on endpoints.                               | A, M, U, R    | `read endpoint-parameters`              |
| Search & list endpoint parameters    | List, filter and search parameters (query, path and header) defined on endpoints.                                   | A, M, U, R    | `search endpoint-parameters`            |
| Create endpoint parameters           | Add new parameters (query, path and header) defined on endpoints.                                                   | A, M          | `create endpoint-parameters`            |
| Update endpoint parameters           | Edit existing parameters (query, path and header) defined on endpoints.                                             | A, M          | `update endpoint-parameters`            |
| Delete endpoint parameters           | Permanently remove parameters (query, path and header) defined on endpoints.                                        | A, M          | `delete endpoint-parameters`            |
| View request options                 | Open and see the details of request options applied to endpoint calls.                                              | A, M, U, R    | `read request-options`                  |
| Search & list request options        | List, filter and search request options applied to endpoint calls.                                                  | A, M, U, R    | `search request-options`                |
| Create request options               | Add new request options applied to endpoint calls.                                                                  | A, M          | `create request-options`                |
| Update request options               | Edit existing request options applied to endpoint calls.                                                            | A, M          | `update request-options`                |
| Delete request options               | Permanently remove request options applied to endpoint calls.                                                       | A, M          | `delete request-options`                |
| Search & list field tags             | List, filter and search tags used to classify fields in connector schemas.                                          | A, M, U, R    | `search field-tags`                     |
| Create field tags                    | Add new tags used to classify fields in connector schemas.                                                          | A, M          | `create field-tags`                     |
| Update field tags                    | Edit existing tags used to classify fields in connector schemas.                                                    | A, M          | `update field-tags`                     |
| Delete field tags                    | Permanently remove tags used to classify fields in connector schemas.                                               | A, M          | `delete field-tags`                     |
| View connector variables             | Open and see the details of variables defined on connectors and endpoints.                                          | A, M, U, R    | `read variables`                        |
| Search & list connector variables    | List, filter and search variables defined on connectors and endpoints.                                              | A, M, U, R    | `search variables`                      |
| Create connector variables           | Add new variables defined on connectors and endpoints.                                                              | A, M          | `create variables`                      |
| Update connector variables           | Edit existing variables defined on connectors and endpoints.                                                        | A, M          | `update variables`                      |
| Delete connector variables           | Permanently remove variables defined on connectors and endpoints.                                                   | A, M          | `delete variables`                      |
| View model variables                 | Open and see the details of variables attached to a specific item such as a connector instance.                     | A, M, U, R    | `read model-variables`                  |
| Search & list model variables        | List, filter and search variables attached to a specific item such as a connector instance.                         | A, M, U, R    | `search model-variables`                |
| Create model variables               | Add new variables attached to a specific item such as a connector instance.                                         | A, M          | `create model-variables`                |
| Update model variables               | Edit existing variables attached to a specific item such as a connector instance.                                   | A, M          | `update model-variables`                |
| Delete model variables               | Permanently remove variables attached to a specific item such as a connector instance.                              | A, M          | `delete model-variables`                |
| View system types                    | Open and see the details of the categories used to group systems (for example ERP or eCommerce).                    | A, M, U, R    | `read system-types`                     |
| Search & list system types           | List, filter and search the categories used to group systems (for example ERP or eCommerce).                        | A, M, U, R    | `search system-types`                   |
| View system templates                | Open and see the details of templates used to create new connector definitions.                                     | A, M, U, R    | `read system-templates`                 |
| Search & list system templates       | List, filter and search templates used to create new connector definitions.                                         | A, M, U, R    | `search system-templates`               |
| View entity types                    | Open and see the details of the data entity types a connector can work with (for example orders or products).       | A, M, U, R    | `read entity-types`                     |
| Search & list entity types           | List, filter and search the data entity types a connector can work with (for example orders or products).           | A, M, U, R    | `search entity-types`                   |

#### Process flows

Process flows are built on the canvas from shapes (steps), and are versioned and deployed.

| Task                                   | What it lets you do                                                                                         | Allowed roles           | Permission                        |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------- | --------------------------------- |
| View process flows                     | Open and see the details of process flows.                                                                  | A, M, U, R              | `read flows`                      |
| Search & list process flows            | List, filter and search process flows.                                                                      | A, M, U, R              | `search flows`                    |
| Create process flows                   | Add new process flows.                                                                                      | A, M                    | `create flows`                    |
| Update process flows                   | Edit existing process flows.                                                                                | A, M                    | `update flows`                    |
| Delete process flows                   | Permanently remove process flows.                                                                           | A, M                    | `delete flows`                    |
| Run process flow manually              | Start a process flow run on demand.                                                                         | A, M                    | `trigger flows`                   |
| Enable & deploy process flows          | Enable a process flow and deploy a version so it runs.                                                      | A, M                    | `deploy flows`                    |
| View process flow versions             | Open and see the details of versions of a process flow.                                                     | A, M, U, R              | `read flow-versions`              |
| Search & list process flow versions    | List, filter and search versions of a process flow.                                                         | A, M, U, R              | `search flow-versions`            |
| Create process flow versions           | Add new versions of a process flow.                                                                         | A, M                    | `create flow-versions`            |
| Update process flow versions           | Edit existing versions of a process flow.                                                                   | A, M                    | `update flow-versions`            |
| Delete process flow versions           | Permanently remove versions of a process flow.                                                              | A, M                    | `delete flow-versions`            |
| View flow variables                    | Open and see the details of flow variables set on a process flow version.                                   | A, M, U, R              | `read flow-version-variables`     |
| Create flow variables                  | Add new flow variables set on a process flow version.                                                       | A, M                    | `create flow-version-variables`   |
| Update flow variables                  | Edit existing flow variables set on a process flow version.                                                 | A, M                    | `update flow-version-variables`   |
| Delete flow variables                  | Permanently remove flow variables set on a process flow version.                                            | A, M                    | `delete flow-version-variables`   |
| View flow steps (shapes)               | Open and see the details of the shapes that make up a process flow.                                         | A, M, U, R              | `read flow-steps`                 |
| Search & list flow steps (shapes)      | List, filter and search the shapes that make up a process flow.                                             | A, M, U, R              | `search flow-steps`               |
| Create flow steps (shapes)             | Add new shapes that make up a process flow.                                                                 | A, M                    | `create flow-steps`               |
| Update flow steps (shapes)             | Edit existing shapes that make up a process flow.                                                           | A, M                    | `update flow-steps`               |
| Delete flow steps (shapes)             | Permanently remove the shapes that make up a process flow.                                                  | A, M                    | `delete flow-steps`               |
| Add shapes to the canvas               | Drop new shapes onto a process flow canvas.                                                                 | A, M                    | `add flow-shapes`                 |
| Change connector instance on a shape   | Change which connector instance a connector shape uses.                                                     | A, M                    | `update flow-step-instance`       |
| Change endpoint on a shape             | Change which endpoint a connector shape calls.                                                              | A, M                    | `update flow-step-endpoint`       |
| Create shape filters                   | Add new filters configured on a flow shape.                                                                 | A, M                    | `create flow-step-filters`        |
| Update shape filters                   | Edit existing filters configured on a flow shape.                                                           | A, M                    | `update flow-step-filters`        |
| Delete shape filters                   | Permanently remove filters configured on a flow shape.                                                      | A, M                    | `delete flow-step-filters`        |
| Create shape schedules                 | Add new schedules configured on a trigger shape.                                                            | A, M                    | `create flow-step-schedules`      |
| Update shape schedules                 | Edit existing schedules configured on a trigger shape.                                                      | A, M                    | `update flow-step-schedules`      |
| Delete shape schedules                 | Permanently remove schedules configured on a trigger shape.                                                 | A, M                    | `delete flow-step-schedules`      |
| View process flow schedules            | Open and see the details of run schedules for a process flow.                                               | A, M, U, R              | `read flow-schedules`             |
| Search & list process flow schedules   | List, filter and search run schedules for a process flow.                                                   | A, M, U, R              | `search flow-schedules`           |
| Create process flow schedules          | Add new run schedules for a process flow.                                                                   | A, M                    | `create flow-schedules`           |
| Update process flow schedules          | Edit existing run schedules for a process flow.                                                             | A, M                    | `update flow-schedules`           |
| Delete process flow schedules          | Permanently remove run schedules for a process flow.                                                        | A, M                    | `delete flow-schedules`           |
| Search & list scheduled runs           | List, filter and search process flow runs that are queued to run at a scheduled time.                       | A, M, U, R              | `search scheduled-flows`          |
| Delete scheduled runs                  | Permanently remove process flow runs that are queued to run at a scheduled time.                            | A, M                    | `delete scheduled-flows`          |
| View filters                           | Open and see the details of saved filters used by filter shapes.                                            | A, M, U, R              | `read filters`                    |
| Search & list filters                  | List, filter and search saved filters used by filter shapes.                                                | A, M, U, R              | `search filters`                  |
| Create filters                         | Add new saved filters used by filter shapes.                                                                | A, M, U                 | `create filters`                  |
| Update filters                         | Edit existing saved filters used by filter shapes.                                                          | A, M, U                 | `update filters`                  |
| Delete filters                         | Permanently remove saved filters used by filter shapes.                                                     | A, M, U                 | `delete filters`                  |
| View filter types                      | Open and see the details of the filter types available when building filters.                               | A, M, U, R              | `read filter-types`               |
| Search & list filter types             | List, filter and search the filter types available when building filters.                                   | A, M, U, R              | `search filter-types`             |
| View filter operators                  | Open and see the details of the operators (for example equals or contains) available when building filters. | A, M, U, R              | `read filter-operators`           |
| Search & list filter operators         | List, filter and search the operators (for example equals or contains) available when building filters.     | A, M, U, R              | `search filter-operators`         |
| View filter fields                     | Open and see the details of the fields available to filter on.                                              | A, M, U, R              | `read filter-fields`              |
| Search & list filter fields            | List, filter and search the fields available to filter on.                                                  | A, M, U, R              | `search filter-fields`            |
| View filter templates                  | Open and see the details of predefined filter templates.                                                    | A, M, U, R              | `read filter-templates`           |
| Search & list filter templates         | List, filter and search predefined filter templates.                                                        | A, M, U, R              | `search filter-templates`         |
| View transformation functions          | Open and see the details of the functions available in field mapping and the Data Transformation shape.     | A, M, U, R              | `read transformation-functions`   |
| Search & list transformation functions | List, filter and search the functions available in field mapping and the Data Transformation shape.         | A, M, U, R              | `search transformation-functions` |
| Create labels on process flows         | Add new labels applied to a process flow.                                                                   | A, M                    | `create flow-labels`              |
| Update labels on process flows         | Edit existing labels applied to a process flow.                                                             | A, M                    | `update flow-labels`              |
| Delete labels on process flows         | Permanently remove labels applied to a process flow.                                                        | A, M                    | `delete flow-labels`              |
| Apply/remove email failure groups      | Choose which notification groups are emailed when a process flow fails.                                     | A, M                    | `update flow-notification-groups` |
| View notes                             | Open and see the details of notes added to process flows and other items.                                   | A, M, U, R              | `read model-notes`                |
| Search & list notes                    | List, filter and search notes added to process flows and other items.                                       | A, M, U, R              | `search model-notes`              |
| Create notes                           | Add new notes added to process flows and other items.                                                       | A, M, U                 | `create model-notes`              |
| Update notes                           | Edit existing notes added to process flows and other items.                                                 | A, M, U                 | `update model-notes`              |
| Delete notes                           | Permanently remove notes added to process flows and other items.                                            | A, M, U                 | `delete model-notes`              |
| Use JSON editor                        | Edit shape settings and payloads directly as raw JSON.                                                      | Advanced editor bolt-on | `json editor`                     |
| Use cron editor                        | Write schedules as custom cron expressions instead of using the schedule picker.                            | Advanced editor bolt-on | `cron editor`                     |

#### Message brokers

Message brokers let process flows send and receive messages through queues.

| Task                                | What it lets you do                                         | Allowed roles | Permission                     |
| ----------------------------------- | ----------------------------------------------------------- | ------------- | ------------------------------ |
| View message brokers                | Open and see the details of message broker connections.     | A, M, U, R    | `read message-brokers`         |
| Search & list message brokers       | List, filter and search message broker connections.         | A, M, U, R    | `search message-brokers`       |
| Create message brokers              | Add new message broker connections.                         | A, M, U       | `create message-brokers`       |
| Update message brokers              | Edit existing message broker connections.                   | A, M, U       | `update message-brokers`       |
| Delete message brokers              | Permanently remove message broker connections.              | A, M, U       | `delete message-brokers`       |
| View message broker queues          | Open and see the details of the queues on a message broker. | A, M, U, R    | `read message-broker-queues`   |
| Search & list message broker queues | List, filter and search the queues on a message broker.     | A, M, U, R    | `search message-broker-queues` |
| Create message broker queues        | Add new queues on a message broker.                         | A, M, U       | `create message-broker-queues` |
| Update message broker queues        | Edit existing queues on a message broker.                   | A, M, U       | `update message-broker-queues` |
| Delete message broker queues        | Permanently remove the queues on a message broker.          | A, M, U       | `delete message-broker-queues` |

#### Webhooks, callbacks and inbound endpoints

These let external systems send data into Patchworks, and let Patchworks respond.

| Task                             | What it lets you do                                                                                            | Allowed roles | Permission                  |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------- | --------------------------- |
| View webhooks                    | Open and see the details of webhooks that trigger process flows when an external system sends data.            | A, M, U, R    | `read webhooks`             |
| Search & list webhooks           | List, filter and search webhooks that trigger process flows when an external system sends data.                | A, M, U, R    | `search webhooks`           |
| Create webhooks                  | Add new webhooks that trigger process flows when an external system sends data.                                | A, M          | `create webhooks`           |
| Update webhooks                  | Edit existing webhooks that trigger process flows when an external system sends data.                          | A, M          | `update webhooks`           |
| Delete webhooks                  | Permanently remove webhooks that trigger process flows when an external system sends data.                     | A, M          | `delete webhooks`           |
| View callbacks                   | Open and see the details of callbacks that let an external system call a process flow and get a response back. | A, M, U, R    | `read callbacks`            |
| Search & list callbacks          | List, filter and search callbacks that let an external system call a process flow and get a response back.     | A, M, U, R    | `search callbacks`          |
| Create callbacks                 | Add new callbacks that let an external system call a process flow and get a response back.                     | A, M          | `create callbacks`          |
| Update callbacks                 | Edit existing callbacks that let an external system call a process flow and get a response back.               | A, M          | `update callbacks`          |
| Delete callbacks                 | Permanently remove callbacks that let an external system call a process flow and get a response back.          | A, M          | `delete callbacks`          |
| View inbound endpoints           | Open and see the details of inbound endpoints that receive data from external systems.                         | A, M, U, R    | `read inbound-endpoints`    |
| Search & list inbound endpoints  | List, filter and search inbound endpoints that receive data from external systems.                             | A, M, U, R    | `search inbound-endpoints`  |
| Create inbound endpoints         | Add new inbound endpoints that receive data from external systems.                                             | A, M, U       | `create inbound-endpoints`  |
| Update inbound endpoints         | Edit existing inbound endpoints that receive data from external systems.                                       | A, M, U       | `update inbound-endpoints`  |
| Delete inbound endpoints         | Permanently remove inbound endpoints that receive data from external systems.                                  | A, M, U       | `delete inbound-endpoints`  |
| View system event types          | Open and see the details of the event types a system can send.                                                 | A, M, U, R    | `read system-event-types`   |
| Search & list system event types | List, filter and search the event types a system can send.                                                     | A, M, U, R    | `search system-event-types` |

#### Virtual environments

[Virtual environments](https://doc.wearepatchworks.com/product-documentation/virtual-environments/about-virtual-environments) let you run separate versions of your process flows (for example test and production), and deploy them as packages.

| Task                                              | What it lets you do                                                                                 | Allowed roles | Permission                                           |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ------------- | ---------------------------------------------------- |
| View virtual environments                         | Open and see the details of virtual environments.                                                   | A, M, U, R    | `read virtual-environments`                          |
| Search & list virtual environments                | List, filter and search virtual environments.                                                       | A, M, U, R    | `search virtual-environments`                        |
| Create virtual environments                       | Add new virtual environments.                                                                       | A, M          | `create virtual-environments`                        |
| Update virtual environments                       | Edit existing virtual environments.                                                                 | A, M          | `update virtual-environments`                        |
| Delete virtual environments                       | Permanently remove virtual environments.                                                            | A, M          | `delete virtual-environments`                        |
| View virtual environment versions                 | Open and see the details of versions of a virtual environment.                                      | A, M, U, R    | `read virtual-environment-versions`                  |
| Search & list virtual environment versions        | List, filter and search versions of a virtual environment.                                          | A, M, U, R    | `search virtual-environment-versions`                |
| Create virtual environment versions               | Add new versions of a virtual environment.                                                          | A, M          | `create virtual-environment-versions`                |
| Update virtual environment versions               | Edit existing versions of a virtual environment.                                                    | A, M          | `update virtual-environment-versions`                |
| Delete virtual environment versions               | Permanently remove versions of a virtual environment.                                               | A, M          | `delete virtual-environment-versions`                |
| View virtual environment variables                | Open and see the details of variables set for a virtual environment version.                        | A, M, U, R    | `read virtual-environment-version-variables`         |
| Search & list virtual environment variables       | List, filter and search variables set for a virtual environment version.                            | A, M, U, R    | `search virtual-environment-version-variables`       |
| Create virtual environment variables              | Add new variables set for a virtual environment version.                                            | A, M          | `create virtual-environment-version-variables`       |
| Update virtual environment variables              | Edit existing variables set for a virtual environment version.                                      | A, M          | `update virtual-environment-version-variables`       |
| Delete virtual environment variables              | Permanently remove variables set for a virtual environment version.                                 | A, M          | `delete virtual-environment-version-variables`       |
| View virtual environment manifests                | Open and see the details of the manifest listing what a virtual environment version contains.       | A, M, U, R    | `read virtual-environment-version-manifests`         |
| Search & list virtual environment manifests       | List, filter and search the manifest listing what a virtual environment version contains.           | A, M, U, R    | `search virtual-environment-version-manifests`       |
| Create virtual environment manifests              | Add new manifest listing what a virtual environment version contains.                               | A, M          | `create virtual-environment-version-manifests`       |
| Update virtual environment manifests              | Edit existing manifest listing what a virtual environment version contains.                         | A, M          | `update virtual-environment-version-manifests`       |
| Delete virtual environment manifests              | Permanently remove the manifest listing what a virtual environment version contains.                | A, M          | `delete virtual-environment-version-manifests`       |
| View virtual environment flow priorities          | Open and see the details of the run priority of process flows in a virtual environment.             | A, M, U, R    | `read virtual-environment-version-flow-priorities`   |
| Search & list virtual environment flow priorities | List, filter and search the run priority of process flows in a virtual environment.                 | A, M, U, R    | `search virtual-environment-version-flow-priorities` |
| Create virtual environment flow priorities        | Add new run priority of process flows in a virtual environment.                                     | A, M          | `create virtual-environment-version-flow-priorities` |
| Update virtual environment flow priorities        | Edit existing run priority of process flows in a virtual environment.                               | A, M          | `update virtual-environment-version-flow-priorities` |
| Delete virtual environment flow priorities        | Permanently remove the run priority of process flows in a virtual environment.                      | A, M          | `delete virtual-environment-version-flow-priorities` |
| View flow deployments                             | Open and see the details of deployments of a process flow version to a virtual environment.         | A, M, U, R    | `read flow-version-deployments`                      |
| Search & list flow deployments                    | List, filter and search deployments of a process flow version to a virtual environment.             | A, M, U, R    | `search flow-version-deployments`                    |
| Create flow deployments                           | Add new deployments of a process flow version to a virtual environment.                             | A, M          | `create flow-version-deployments`                    |
| Update flow deployments                           | Edit existing deployments of a process flow version to a virtual environment.                       | A, M          | `update flow-version-deployments`                    |
| Delete flow deployments                           | Permanently remove deployments of a process flow version to a virtual environment.                  | A, M          | `delete flow-version-deployments`                    |
| View packages                                     | Open and see the details of packages of process flows that can be deployed to virtual environments. | A, M, U, R    | `read packages`                                      |
| Search & list packages                            | List, filter and search packages of process flows that can be deployed to virtual environments.     | A, M, U, R    | `search packages`                                    |
| Create packages                                   | Add new packages of process flows that can be deployed to virtual environments.                     | A, M          | `create packages`                                    |
| Update packages                                   | Edit existing packages of process flows that can be deployed to virtual environments.               | A, M          | `update packages`                                    |
| Delete packages                                   | Permanently remove packages of process flows that can be deployed to virtual environments.          | A, M          | `delete packages`                                    |
| View package versions                             | Open and see the details of versions of a package.                                                  | A, M, U, R    | `read package-versions`                              |
| Search & list package versions                    | List, filter and search versions of a package.                                                      | A, M, U, R    | `search package-versions`                            |
| Create package flow versions                      | Add new process flow versions included in a package.                                                | A, M          | `create package-flow-versions`                       |
| Update package flow versions                      | Edit existing process flow versions included in a package.                                          | A, M          | `update package-flow-versions`                       |
| Delete package flow versions                      | Permanently remove the process flow versions included in a package.                                 | A, M          | `delete package-flow-versions`                       |

#### Run logs

Run logs show what happened each time a process flow ran.

| Task                      | What it lets you do                                                       | Allowed roles | Permission             |
| ------------------------- | ------------------------------------------------------------------------- | ------------- | ---------------------- |
| View run logs             | List and search process flow run logs and their details.                  | A, M, U, R    | `search event-logs`    |
| View run log payloads     | List the payload files stored for a process flow run.                     | A, M          | `search media-files`   |
| Download run log payloads | Download payload files from a process flow run.                           | A, M          | `download media-files` |
| Search tracked data       | Search data that has been tracked as it moved through your process flows. | A, M, U, R    | `search tracked-data`  |

#### General settings

General settings cover notification groups, labels, data pools and audit logs. For your own account settings, see [managing your own user account](https://doc.wearepatchworks.com/product-documentation/users-roles-and-permissions/managing-your-own-user-account).

| Task                                  | What it lets you do                                                                   | Allowed roles | Permission                       |
| ------------------------------------- | ------------------------------------------------------------------------------------- | ------------- | -------------------------------- |
| View notification groups              | Open and see the details of notification groups used for process flow failure emails. | A, M, U, R    | `read notification-groups`       |
| Search & list notification groups     | List, filter and search notification groups used for process flow failure emails.     | A, M, U, R    | `search notification-groups`     |
| Create notification groups            | Add new notification groups used for process flow failure emails.                     | A, M, U       | `create notification-groups`     |
| Update notification groups            | Edit existing notification groups used for process flow failure emails.               | A, M, U       | `update notification-groups`     |
| Delete notification groups            | Permanently remove notification groups used for process flow failure emails.          | A, M, U       | `delete notification-groups`     |
| View notification recipients          | Open and see the details of the people in a notification group.                       | A, M, U, R    | `read notification-recipients`   |
| Search & list notification recipients | List, filter and search the people in a notification group.                           | A, M, U, R    | `search notification-recipients` |
| Create notification recipients        | Add new people in a notification group.                                               | A, M, U       | `create notification-recipients` |
| Update notification recipients        | Edit existing people in a notification group.                                         | A, M, U       | `update notification-recipients` |
| Delete notification recipients        | Permanently remove the people in a notification group.                                | A, M, U       | `delete notification-recipients` |
| View labels                           | Open and see the details of labels used to organise process flows.                    | A, M, U, R    | `read labels`                    |
| Search & list labels                  | List, filter and search labels used to organise process flows.                        | A, M, U, R    | `search labels`                  |
| Create labels                         | Add new labels used to organise process flows.                                        | A, M          | `create labels`                  |
| Update labels                         | Edit existing labels used to organise process flows.                                  | A, M          | `update labels`                  |
| Delete labels                         | Permanently remove labels used to organise process flows.                             | A, M          | `delete labels`                  |
| View data pools                       | Open and see the details of data pools used by the de-dupe shape.                     | A, M, U, R    | `read data-pool`                 |
| Search & list data pools              | List, filter and search data pools used by the de-dupe shape.                         | A, M, U, R    | `search data-pool`               |
| Create data pools                     | Add new data pools used by the de-dupe shape.                                         | A, M          | `create data-pool`               |
| Update data pools                     | Edit existing data pools used by the de-dupe shape.                                   | A, M          | `update data-pool`               |
| Delete data pools                     | Permanently remove data pools used by the de-dupe shape.                              | A, M          | `delete data-pool`               |
| Search & list de-duped data           | List, filter and search records held in a data pool.                                  | A, M, U, R    | `search deduped-data`            |
| Create de-duped data                  | Add new records held in a data pool.                                                  | A, M          | `create deduped-data`            |
| Delete de-duped data                  | Permanently remove records held in a data pool.                                       | A, M          | `delete deduped-data`            |
| View audit logs                       | Open the audit log of changes made in your company.                                   | A, M, U, R    | `view audit-logs`                |
| Search audit logs                     | Filter and search the audit log.                                                      | A, M, U, R    | `search audit-logs`              |

#### Custom scripts

Custom scripts are your own code, used in script shapes and field mappings.

| Task                         | What it lets you do                         | Allowed roles | Permission       |
| ---------------------------- | ------------------------------------------- | ------------- | ---------------- |
| View custom scripts          | Open and see the details of custom scripts. | A, M, U, R    | `read scripts`   |
| Search & list custom scripts | List, filter and search custom scripts.     | A, M, U, R    | `search scripts` |
| Create custom scripts        | Add new custom scripts.                     | A, M          | `create scripts` |
| Update custom scripts        | Edit existing custom scripts.               | A, M          | `update scripts` |
| Delete custom scripts        | Permanently remove custom scripts.          | A, M          | `delete scripts` |

#### Cross-reference lookups

Cross-reference lookups translate values between systems (for example a shipping method code in one system to its equivalent in another).

| Task                                        | What it lets you do                                                      | Allowed roles | Permission                             |
| ------------------------------------------- | ------------------------------------------------------------------------ | ------------- | -------------------------------------- |
| View cross-reference lookups                | Open and see the details of cross-reference lookups.                     | A, M, U, R    | `read cross-reference-lookups`         |
| Search & list cross-reference lookups       | List, filter and search cross-reference lookups.                         | A, M, U, R    | `search cross-reference-lookups`       |
| Create cross-reference lookups              | Add new cross-reference lookups.                                         | A, M          | `create cross-reference-lookups`       |
| Update cross-reference lookups              | Edit existing cross-reference lookups.                                   | A, M          | `update cross-reference-lookups`       |
| Delete cross-reference lookups              | Permanently remove cross-reference lookups.                              | A, M          | `delete cross-reference-lookups`       |
| View cross-reference lookup values          | Open and see the details of the values held in a cross-reference lookup. | A, M, U, R    | `read cross-reference-lookup-values`   |
| Search & list cross-reference lookup values | List, filter and search the values held in a cross-reference lookup.     | A, M, U, R    | `search cross-reference-lookup-values` |
| Create cross-reference lookup values        | Add new values held in a cross-reference lookup.                         | A, M          | `create cross-reference-lookup-values` |
| Update cross-reference lookup values        | Edit existing values held in a cross-reference lookup.                   | A, M          | `update cross-reference-lookup-values` |
| Delete cross-reference lookup values        | Permanently remove the values held in a cross-reference lookup.          | A, M          | `delete cross-reference-lookup-values` |

#### Caches

Caches store data during and between process flow runs.

| Task                 | What it lets you do                                    | Allowed roles | Permission      |
| -------------------- | ------------------------------------------------------ | ------------- | --------------- |
| View caches          | Open and see the details of caches and their contents. | A, M, U, R    | `read caches`   |
| Search & list caches | List, filter and search caches and their contents.     | A, M, U, R    | `search caches` |
| Create caches        | Add new caches and their contents.                     | A, M, U       | `create caches` |
| Update caches        | Edit existing caches and their contents.               | A, M, U       | `update caches` |
| Delete caches        | Permanently remove caches and their contents.          | A, M, U       | `delete caches` |
| Clear cache contents | Empty a cache without deleting it.                     | A, M, U       | `clear cache`   |

#### AI

AI features include the AI assistant and AI Studio.

| Task                           | What it lets you do                                                                    | Allowed roles     | Permission                |
| ------------------------------ | -------------------------------------------------------------------------------------- | ----------------- | ------------------------- |
| View AI conversations          | Open the AI conversations page and see conversations with the Patchworks AI assistant. | A, M, U, R        | `view ai-conversations`   |
| Search & list AI conversations | List, filter and search conversations with the Patchworks AI assistant.                | A, M, U, R        | `search ai-conversations` |
| Create AI conversations        | Add new conversations with the Patchworks AI assistant.                                | A, M              | `create ai-conversations` |
| Update AI conversations        | Edit existing conversations with the Patchworks AI assistant.                          | A, M              | `update ai-conversations` |
| Use AI Studio                  | Access AI Studio. This is available as a bolt-on role.                                 | AI Studio bolt-on | `use ai-studio`           |

#### Patchworks API

The Patchworks API gives programmatic access to your company. API keys are scoped to your company.

| Task            | What it lets you do                                 | Allowed roles | Permission        |
| --------------- | --------------------------------------------------- | ------------- | ----------------- |
| Create API keys | Add new API keys for the Patchworks API.            | A, M          | `create api keys` |
| Update API keys | Edit existing API keys for the Patchworks API.      | A, M          | `update api keys` |
| Delete API keys | Permanently remove API keys for the Patchworks API. | A, M          | `delete api keys` |
