> ## Documentation Index
> Fetch the complete documentation index at: https://docs.printools.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Scopes

> Grant the least the integration needs.

Grant the permissions your integration needs. Each operation page lists its required scopes, including additional read permissions for responses that combine resources.

When an operation lists multiple required scopes, grant all of them.

## Find the current scope catalogue

Read [Available scopes](/api/reference/get_v1_reference_scopes) and check [Get current account](/api/reference/get_v1_me) to see the scopes granted to your credential.

## Scopes used by this reference

| Resource       | Scopes                                                                |
| -------------- | --------------------------------------------------------------------- |
| customers      | `customers.read`, `customers.write`                                   |
| customfields   | `customfields.read`, `customfields.write`                             |
| customstatuses | `customstatuses.read`, `customstatuses.write`                         |
| decorations    | `decorations.read`, `decorations.write`                               |
| documents      | `documents.read`                                                      |
| garments       | `garments.read`, `garments.write`                                     |
| invoices       | `invoices.read`, `invoices.settle`, `invoices.sync`, `invoices.write` |
| jobs           | `jobs.read`, `jobs.write`                                             |
| media          | `media.write`                                                         |
| prebuiltitems  | `prebuiltitems.read`, `prebuiltitems.write`                           |
| proofs         | `proofs.approve`, `proofs.read`, `proofs.write`                       |
| purchaseorders | `purchaseorders.read`, `purchaseorders.write`                         |
| quotes         | `quotes.read`, `quotes.write`                                         |
| tasks          | `tasks.read`, `tasks.write`                                           |
| vendors        | `vendors.read`, `vendors.write`                                       |
| webhooks       | `webhooks.read`, `webhooks.write`                                     |

## Combined operations

A full-detail read or conversion may need permissions on more than one resource. For example, quote-to-job conversion requires both `quotes.write` and `jobs.write`. Follow the scope list on the operation page rather than assuming one resource scope is sufficient.

A `403` can mean a required scope or an actor permission is missing. Authentication is described separately under [Authentication](/api/authentication).