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

> RCS channel permissions: send, query, and cancel rich messages.

<Tip>
  Each scope is a **door** on your key: send, query, or cancel, open only what you need.
</Tip>

Each **scope** unlocks one type of RCS operation. Use only what your integration needs.

## How to send the key

**Recommended**

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

**Alternative**

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

<Info>
  Each API Key belongs to **one** workspace. You cannot access another workspace with the same key.
</Info>

## Common combinations

<CardGroup cols={2}>
  <Card title="Send only" icon="paper-plane">
    `rcs:send`
  </Card>

  <Card title="Send and query" icon="magnifying-glass">
    `rcs:send`, `rcs:read`
  </Card>

  <Card title="With scheduling" icon="clock">
    `rcs:send`, `rcs:cancel`
  </Card>

  <Card title="Full flow" icon="list-check">
    `rcs:send`, `rcs:read`, `rcs:cancel`
  </Card>
</CardGroup>

<Warning>
  An **empty** scope list on creation = **ADMIN** access. Always restrict in production.
</Warning>

## Available scopes

<AccordionGroup>
  <Accordion title="rcs:send">
    Send immediate or scheduled RCS to 1 to 100 numbers per request. Types: BASIC, CARD, CAROUSEL, FILE.
  </Accordion>

  <Accordion title="rcs:read">
    Query status and data for one send by id.
  </Accordion>

  <Accordion title="rcs:cancel">
    Cancel queued or scheduled message. Only with `QUEUED` or `SCHEDULED` status. Credits refunded when applicable.
  </Accordion>
</AccordionGroup>

## Common errors

<AccordionGroup>
  <Accordion title="401: missing, invalid, or revoked key">
    Check `Authorization: Bearer sk_...` and that the key wasn't deleted in the dashboard.
  </Accordion>

  <Accordion title="402: blocked plan">
    Suspended or expired workspace. Fix the plan in the dashboard.
  </Accordion>

  <Accordion title="403: missing scope or plan limit">
    Check operation scope. On send, verify credits (**60 per message**, `PLAN_LIMIT_CREDITS`) and whether scheduling is on the plan (`PLAN_LIMIT_SCHEDULING`).
  </Accordion>

  <Accordion title="400: invalid cancel">
    Cancel only works with `QUEUED` or `SCHEDULED` status. After send, cancellation is not available.
  </Accordion>
</AccordionGroup>

## Next steps

* [Quick Start](/en/rcs-api/como-funciona/quick-start)
* [Webhook events](/en/rcs-api/como-funciona/eventos-do-webhooks)
* [API Keys guide](/en/guides/api-key/index)