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

# Scopes

> Choose the right permissions for your API key.

Scopes control what an API key can access. Follow the principle of least privilege: request only the scopes your integration needs.

## Scope format

Scopes follow the pattern `resource:action`:

* `:read` - List and view resources
* `:write` - Create and update resources
* `:delete` - Archive or delete resources

<Note>
  `:write` does not include `:delete`. If your integration needs to archive contacts, you must request both `contacts:write` and `contacts:delete`.
</Note>

## Common use cases

<AccordionGroup>
  <Accordion title="Read-only reporting dashboard">
    Use the `read_only` bundle, which includes all `:read` scopes.

    ```
    contacts:read, companies:read, deals:read, notes:read,
    tags:read, tasks:read, enrichment:read, messages:read,
    projects:read, pipeline:read, sequences:read, sourcing:read
    ```
  </Accordion>

  <Accordion title="AI recruiter agent">
    An AI agent that sources candidates, enrolls them in sequences, and manages pipeline stages:

    ```
    contacts:read, contacts:write
    projects:read
    pipeline:read, pipeline:write
    sequences:read, sequences:write
    sourcing:read, sourcing:write
    ```
  </Accordion>

  <Accordion title="CRM sync">
    Syncing contacts, companies, and deals with an external CRM:

    ```
    contacts:read, contacts:write
    companies:read, companies:write
    deals:read, deals:write
    notes:read, notes:write
    tags:read
    ```

    Or use the `crm` bundle.
  </Accordion>

  <Accordion title="Enrichment automation">
    Automatically enrich contacts and check results:

    ```
    contacts:read
    enrichment:read, enrichment:write
    ```
  </Accordion>
</AccordionGroup>

## Bundles

Bundles are pre-configured groups of scopes for common integrations:

| Bundle        | Scopes included                                  |
| ------------- | ------------------------------------------------ |
| `full_access` | Every scope                                      |
| `read_only`   | All `:read` scopes                               |
| `crm`         | Companies, deals, contacts, notes, tags          |
| `automation`  | Sequences, contacts, pipeline, enrichment, tasks |
| `sourcing`    | Contacts, projects, pipeline, sourcing           |