> ## 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.

# Escopos da API Key

> short_links:read, short_links:manage e conversions:manage.

<Tip>
  Escopos valem só para **`/v1/short-links`** e **`POST /v1/conversions`**. Enviar SMS/WhatsApp ainda exige escopos do canal.
</Tip>

## Como enviar a chave

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

<Warning>
  **Não** envie `x-workspace-id` na API v1.
</Warning>

## Escopos

<AccordionGroup>
  <Accordion title="short_links:read">
    * `GET /v1/short-links`
    * `GET /v1/short-links/{id}`
    * `GET /v1/short-links/{id}/analytics`
    * `GET /v1/short-links/{id}/clicks`
  </Accordion>

  <Accordion title="short_links:manage">
    * `POST /v1/short-links`
    * `PATCH /v1/short-links/{id}`
    * `DELETE /v1/short-links/{id}`
  </Accordion>

  <Accordion title="conversions:manage">
    * `POST /v1/conversions`, registrar pedido atribuído a `msg_id`
  </Accordion>
</AccordionGroup>

## Erros comuns

| HTTP    | Situação                                         |
| ------- | ------------------------------------------------ |
| **403** | Escopo ausente ou links desativados no workspace |
| **400** | `x-workspace-id` enviado na v1                   |

## Próximos passos

* [Quick Start](/short-links-api/como-funciona/quick-start)
* [Smart Links e conversões](/short-links-api/como-funciona/smart-links-e-conversoes)