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

# Alcances de API Key

> Permisos para consultar y modificar la lista de no contactar.

<Tip>
  La **API Key** es la tarjeta de acceso: cada **alcance** abre una puerta. Para supresiones, solo hay dos — lectura y escritura.
</Tip>

## En resumen

* **`suppressions:read`** — listar y consultar entradas.
* **`suppressions:write`** — agregar, importar y eliminar.
* La escritura **no exige** lectura en la misma clave, pero las integraciones de administración suelen usar ambos.

Guía general: [Claves de API](/es/guides/api-key/index). Primer uso: [Inicio rápido](/es/suppressions-api/como-funciona/quick-start).

***

## Cómo enviar la clave

```http theme={null}
Authorization: Bearer sk_live_xxxxx
```

Alternativa: `x-api-key: sk_live_xxxxx`.

<Warning>
  Alcances **vacíos** al crear = acceso **ADMIN** (todo). En producción, restrinja siempre.
</Warning>

***

## Combinaciones listas

<CardGroup cols={2}>
  <Card title="Solo consultar" icon="magnifying-glass">
    `suppressions:read`
  </Card>

  <Card title="Solo modificar" icon="pen">
    `suppressions:write`
  </Card>

  <Card title="Administración completa" icon="list-check">
    `suppressions:read`, `suppressions:write`
  </Card>

  <Card title="CRM + supresiones" icon="address-book">
    `contacts:read`, `suppressions:read`, `suppressions:write`
  </Card>
</CardGroup>

***

## Alcances disponibles

<AccordionGroup>
  <Accordion title="suppressions:read">
    Listar supresiones (`GET /v1/suppressions`) y consultar por ID (`GET /v1/suppressions/{id}`).
  </Accordion>

  <Accordion title="suppressions:write">
    Agregar (`POST /v1/suppressions`), lote (`POST /v1/suppressions/batch/add`), eliminar por ID, por identidad y lote de eliminación.
  </Accordion>
</AccordionGroup>

***

## Errores comunes

| HTTP / `code`          | Qué hacer                                                      |
| ---------------------- | -------------------------------------------------------------- |
| **401** `UNAUTHORIZED` | Verifique `Authorization: Bearer sk_...`                       |
| **403** `FORBIDDEN`    | Incluya `suppressions:read` o `suppressions:write` en la clave |
| **403** otro           | Clave sin acceso al workspace                                  |

Catálogo completo: [Respuestas de error](/es/guides/conceitos/resposta-de-erros).

***

## Próximos pasos

* [Inicio rápido](/es/suppressions-api/como-funciona/quick-start)
* [Eventos de webhooks](/es/suppressions-api/como-funciona/eventos-do-webhooks)
* [Introducción](/es/suppressions-api/como-funciona/introducao)