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

# OAuth scopes

Here is the list of all OAuth scopes in the Lucca API (as of version `2024-11-01`).

Each scope is given a "criticality" level to help you protect your data.

| Scope                                      | Related resources                                                                                                                | Description                                                                                                                                                                                   | Criticality                                          |
| :----------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |
| `legal-entities.readonly`                  | [legal-entity](./organization/legal-entity)                                                                                      | Read [legal-entities](/api-reference/latest/organization/legal-entity).                                                                                                                       | <Badge color="green" shape="rounded">Low</Badge>     |
| `legal-entities.readwrite`                 | [legal-entity](./organization/legal-entity)                                                                                      | Create, update or delete [legal-entities](/api-reference/latest/organization/legal-entity).                                                                                                   | <Badge color="orange" shape="rounded">Medium</Badge> |
| `business-establishments.readonly`         | [business-establishment](./organization/business-establishment)                                                                  | Read [business-establishments](/api-reference/latest/organization/business-establishment).                                                                                                    | <Badge color="green" shape="rounded">Low</Badge>     |
| `business-establishments.readwrite`        | [business-establishment](./organization/business-establishment)                                                                  | Create, update or delete [business-establishments](/api-reference/latest/organization/business-establishment).                                                                                | <Badge color="orange" shape="rounded">Medium</Badge> |
| `departments.readonly`                     | [department](./organization/department)                                                                                          | Read [departments](/api-reference/latest/organization/department).                                                                                                                            | <Badge color="green" shape="rounded">Low</Badge>     |
| `departments.readwrite`                    | [department](./organization/department)                                                                                          | Create, update or delete [departments](/api-reference/latest/organization/department).                                                                                                        | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employees.readonly`                       | [employee](./employees/employee)                                                                                                 | Read [employees](/api-reference/latest/employees/employee).                                                                                                                                   | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employees.readwrite`                      | [employee](./employees/employee)                                                                                                 | Create or update [employees](/api-reference/latest/employees/employee).                                                                                                                       | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employee-attribute-definitions.readonly`  | [employee-attribute-definition](./employee-attributes/employee-attribute-definition)                                             | Read [employee-attribute-definitions](/api-reference/latest/employee-attributes/employee-attribute-definition).                                                                               | <Badge color="green" shape="rounded">Low</Badge>     |
| `employee-attribute-definitions.readwrite` | [employee-attribute-definition](./employee-attributes/employee-attribute-definition)                                             | Create, update or delete [employee-attribute-definitions](/api-reference/latest/employee-attributes/employee-attribute-definition).                                                           | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employee-attributes.readonly`             | [employee-attribute](./employee-attributes/employee-attribute)                                                                   | Read [employee-attributes](/api-reference/latest/employee-attributes/employee-attribute).                                                                                                     | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employee-attributes.readwrite`            | [employee-attribute](./employee-attributes/employee-attribute)                                                                   | Create, update or delete [employee-attributes](/api-reference/latest/employee-attributes/employee-attribute).                                                                                 | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employee-personal-records.readonly`       | [employee-personal-record](./employees/employee-personal-record)                                                                 | Read [employee-personal-records](/api-reference/latest/employees/employee-personal-records). This contains highly sensitive data about the personal detail of the person.                     | <Badge color="red" shape="rounded">High</Badge>      |
| `employee-personal-records.readwrite`      | [employee-personal-record](./employees/employee-personal-record)                                                                 | Create, update or delete [employee-personal-records](/api-reference/latest/employees/employee-personal-records). This contains highly sensitive data about the personal detail of the person. | <Badge color="red" shape="rounded">High</Badge>      |
| `employments.readonly`                     | [employment](./employments/employment)                                                                                           | Read [employments](/api-reference/latest/employments/employment).                                                                                                                             | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employments.readwrite`                    | [employment](./employments/employment)                                                                                           | Create, update or delete [employments](/api-reference/latest/employments/employment).                                                                                                         | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employment-templates.readonly`            | [employment-template](./employments/employment-template)                                                                         | Read [employment-templates](/api-reference/latest/employments/employment-template).                                                                                                           | <Badge color="orange" shape="rounded">Medium</Badge> |
| `employment-templates.readwrite`           | [employment-template](./employments/employment-template)                                                                         | Create, update or archive [employment-templates](/api-reference/latest/employments/employment-template).                                                                                      | <Badge color="orange" shape="rounded">Medium</Badge> |
| `job-positions.readonly`                   | [job-position](./employments/job-position)                                                                                       | Read [job-positions](/api-reference/latest/employments/job-position).                                                                                                                         | <Badge color="green" shape="rounded">Low</Badge>     |
| `job-positions.readwrite`                  | [job-position](./employments/job-position)                                                                                       | Create, update or delete [job-positions](/api-reference/latest/employments/job-position).                                                                                                     | <Badge color="orange" shape="rounded">Medium</Badge> |
| `probationary-periods.readonly`            | [probationary-period](./employments/probationary-period)                                                                         | Read [probationary-periods](/api-reference/latest/employments/probationary-period).                                                                                                           | <Badge color="orange" shape="rounded">Medium</Badge> |
| `probationary-periods.readwrite`           | [probationary-period](./employments/probationary-period)                                                                         | Create, update or delete [probationary-periods](/api-reference/latest/employments/probationary-period).                                                                                       | <Badge color="orange" shape="rounded">Medium</Badge> |
| `occupation-categories.readonly`           | [occupation-category](./employee-occupation-categories/get-started)                                                              | Read [occupation-categories](/api-reference/latest/employee-occupations/occupation-category).                                                                                                 | <Badge color="green" shape="rounded">Low</Badge>     |
| `occupation-categories.readwrite`          | [occupation-category](./employee-occupation-categories/get-started)                                                              | Create, update or delete [occupation-categories](/api-reference/latest/employee-occupations/occupation-category).                                                                             | <Badge color="orange" shape="rounded">Medium</Badge> |
| `job-qualifications.readonly`              | [job-qualification](./employee-job-qualifications/job-qualification) and [professions](./employee-job-qualifications/profession) | Read [job-qualifications](/api-reference/latest/employee-occupations/job-qualification) and [professions](/api-reference/latest/employee-occupations/profession).                             | <Badge color="green" shape="rounded">Low</Badge>     |
| `job-qualifications.readwrite`             | [job-qualification](./employee-job-qualifications/job-qualification) and [professions](./employee-job-qualifications/profession) | Create, update or delete [job-qualifications](/api-reference/latest/employee-occupations/job-qualification) and [professions](/api-reference/latest/employee-occupations/profession).         | <Badge color="orange" shape="rounded">Medium</Badge> |
| `taxonomies.readonly`                      | [taxonomy](./taxonomies/taxonomy) & [taxonomy-label](./taxonomies/taxonomy-label)                                                | Read [taxonomies](/api-reference/latest/taxonomies/taxonomy) and [taxonomy-labels](/api-reference/latest/taxonomies/taxonomy-label).                                                          | <Badge color="green" shape="rounded">Low</Badge>     |
| `taxonomies.readwrite`                     | [taxonomy](./taxonomies/taxonomy) & [taxonomy-label](./taxonomies/taxonomy-label)                                                | Create, update or delete [taxonomies](/api-reference/latest/taxonomies/taxonomy) and [taxonomy-labels](/api-reference/latest/taxonomies/taxonomy-label).                                      | <Badge color="orange" shape="rounded">Medium</Badge> |
| `webhook-endpoints.readonly`               | [webhook-endpoint](./webhooks/webhook-endpoint)                                                                                  | Read webhook-endpoints.                                                                                                                                                                       | <Badge color="green" shape="rounded">Low</Badge>     |
| `webhook-endpoints.readwrite`              | [webhook-endpoint](./webhooks/webhook-endpoint)                                                                                  | Create and update webhook-endpoints.                                                                                                                                                          | <Badge color="orange" shape="rounded">Medium</Badge> |
| `webhook-deliveries.readonly`              | [webhook-delivery](./webhooks/webhook-delivery) & [webhook-delivery-attempt](./webhooks/webhook-delivery-attempt)                | Read webhook-deliveries.                                                                                                                                                                      | <Badge color="green" shape="rounded">Low</Badge>     |
| `webhook-deliveries.readwrite`             | [webhook-delivery](./webhooks/webhook-delivery) & [webhook-delivery-attempt](./webhooks/webhook-delivery-attempt)                | Send a ping event to a webhook-endpoint.                                                                                                                                                      | <Badge color="orange" shape="rounded">Medium</Badge> |
| `working-time-arrangements.readonly`       | [working-time-arrangement](./working-time-arrangements/working-time-arrangement)                                                 | Read working-time-arrangements.                                                                                                                                                               | <Badge color="green" shape="rounded">Low</Badge>     |
| `files.readonly`                           | [file](./files/file)                                                                                                             | Read files stored in Lucca.                                                                                                                                                                   | <Badge color="orange" shape="rounded">Medium</Badge> |
| `files.readwrite`                          | [file](./files/file)                                                                                                             | Upload a file to Lucca.                                                                                                                                                                       | <Badge color="orange" shape="rounded">Medium</Badge> |
