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

# Authentication

> How to authenticate with the MediAPI

## API Keys

All API requests require an API key. Include it in the `X-API-Key` header:

```bash theme={null}
curl https://api.ringbee.dev/v1/jobs \
  -H "X-API-Key: mk_live_abc123..."
```

Or use the `Authorization: Bearer` header:

```bash theme={null}
curl https://api.ringbee.dev/v1/jobs \
  -H "Authorization: Bearer mk_live_abc123..."
```

## Getting a key

1. Sign up at [app.ringbee.dev](https://app.ringbee.dev)
2. Go to the dashboard
3. Click **Create API Key**
4. Copy the key — it's only shown once

## Key security

* API keys are hashed (SHA-256) before storage — we never store the raw key
* Revoke compromised keys immediately from the dashboard
* Use separate keys for development and production
* Never commit keys to source control

## Plans & limits

| Plan       | Monthly GB | Max file size | Priority |
| ---------- | ---------- | ------------- | -------- |
| Free       | 1 GB       | 100 MB        | Low      |
| Pro        | 25 GB      | 2 GB          | Normal   |
| Business   | 200 GB     | 10 GB         | High     |
| Enterprise | Unlimited  | Unlimited     | Highest  |
