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

# API key scopes

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

<Tip>
  Scopes apply only to **`/v1/short-links`** and **`POST /v1/conversions`**. Sending SMS/WhatsApp still needs channel scopes.
</Tip>

## How to send the key

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

<Warning>
  **Do not** send `x-workspace-id` in v1 API.
</Warning>

## Scopes

<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`, register order attributed to `msg_id`
  </Accordion>
</AccordionGroup>

## Common errors

| HTTP    | Situation                                          |
| ------- | -------------------------------------------------- |
| **403** | Missing scope or short links disabled on workspace |
| **400** | `x-workspace-id` sent in v1                        |

## Next steps

* [Quick Start](/en/short-links-api/como-funciona/quick-start)
* [Smart Links and conversions](/en/short-links-api/como-funciona/smart-links-e-conversoes)