> ## 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 clave API

> Permisos para eventos, automatizaciones y ejecuciones.

<Tip>
  Alcances para la **API v1** (clave API). Bases de conocimiento, asistentes y MCP se configuran **en el panel**, no forman parte de la referencia v1.
</Tip>

Cada **alcance** desbloquea un tipo de operación en Automatizaciones. Use solo lo que su integración necesita.

## Cómo enviar la clave

**Recomendado**

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

**Alternativo**

```http theme={null}
x-api-key: sk_live_su_clave_aqui
```

<Info>
  Cada clave API pertenece a **un** espacio de trabajo. No puede acceder a otro espacio de trabajo con la misma clave.
</Info>

## Combinaciones comunes

<CardGroup cols={2}>
  <Card title="Solo enviar eventos" icon="bolt">
    `events:read`, `events:write`
  </Card>

  <Card title="Solo lectura" icon="magnifying-glass">
    `events:read`, `automations:read`
  </Card>

  <Card title="Construir flujos vía API" icon="diagram-project">
    `events:*`, `automations:*`
  </Card>

  <Card title="Integración completa" icon="gear">
    `events:read`, `events:write`, `automations:read`, `automations:write`
  </Card>
</CardGroup>

<Warning>
  Lista de alcances **vacía** al crear = acceso **ADMIN** (todo). En producción, restrinja siempre.
</Warning>

## Eventos (`events:*`)

<AccordionGroup>
  <Accordion title="events:read">
    Listar y recuperar definiciones de eventos.
  </Accordion>

  <Accordion title="events:write">
    Crear, actualizar y eliminar eventos. **Enviar evento** para iniciar ejecuciones.
  </Accordion>
</AccordionGroup>

## Automatizaciones (`automations:*`)

<AccordionGroup>
  <Accordion title="automations:read">
    Listar automatizaciones, obtener detalles y **listar ejecuciones**.
  </Accordion>

  <Accordion title="automations:write">
    Crear, actualizar, eliminar automatizaciones y **detener** una automatización en ejecución.
  </Accordion>
</AccordionGroup>

## Envíos dentro del flujo

Los pasos que envían WhatsApp, correo, SMS, etc. usan el **mismo motor de envío** que los canales. La clave necesita los alcances de envío correspondientes (`whatsapp:send`, `email:send`, `sms:send`, `telegram:send`, etc.).

## Errores comunes

| HTTP    | Situación                                                                                     |
| ------- | --------------------------------------------------------------------------------------------- |
| **403** | Alcance ausente u onboarding incompleto (`ONBOARDING_REQUIRED`)                               |
| **402** | Espacio de trabajo bloqueado o límite de automatizaciones del plan (`PLAN_LIMIT_AUTOMATIONS`) |
| **400** | Grafo inválido (`INVALID_GRAPH`, `GRAPH_CYCLE`, etc.)                                         |

Detalles en [Respuestas de error](/es/guides/conceitos/resposta-de-erros) y la especificación **Automatizaciones y eventos** en el menú.

## Próximos pasos

* [Inicio rápido](/es/automations-api/como-funciona/quick-start)
* [Introducción](/es/automations-api/como-funciona/introducao)
* [Claves API (guía)](/es/guides/api-key/index)