Authentication
All DEB Cloud API calls require authentication via an API key.
API Keys
API keys use the deb_ prefix and are passed as Bearer tokens in the Authorization header.
Authorization: Bearer deb_your_api_key_here
Generating a Key
- Sign in to your DEB Cloud dashboard
- Navigate to API Keys
- Click Generate New Key
- Copy the key immediately — it is shown only once
API keys cannot be retrieved after creation. If you lose a key, revoke it and generate a new one.
Key Security
- Never commit API keys to version control
- Use environment variables to store keys
- Revoke compromised keys immediately from the dashboard
# Set as environment variable
export DEB_CLOUD_API_KEY=deb_your_api_key_here
Rate Limits
Each API key has a per-minute request limit (RPM) determined by your plan. Requests exceeding the limit receive a 429 Too Many Requests response.
| Plan | Requests per Minute |
|---|
| Free Trial | 10 |
| Starter | 30 |
| Pro | 60 |
| Power | 120 |
| Enterprise | Custom |
Retry-After header.
Monthly Quota
Each plan includes a monthly credit allowance. Credits are consumed by tool calls — see Credits for the cost of each tool.
- Free Trial: Hard stop at 100 credits (14-day trial)
- Paid plans: Automatic pay-as-you-go when monthly credits are exhausted
- Usage dashboard: Monitor real-time credit consumption at cloud.debytes.io/dashboard
Error Responses
| Status | Meaning |
|---|
401 Unauthorized | Missing or invalid API key |
403 Forbidden | Key revoked or subscription inactive |
429 Too Many Requests | Rate limit exceeded — retry after delay |
