Base URL
https://enclave.quelden.com/api/v1
For private cloud and on-premise deployments:
https://your-enclave-domain.com/api/v1
Authentication
All API requests require a Bearer token in the Authorization header:
Authorization: Bearer <your_api_token>
Generate API tokens in Settings → API Tokens. Tokens can be scoped to specific operations and have configurable expiry.
API tokens carry the permissions of the user who created them. Store them securely — treat them like passwords.
- All request bodies are JSON (
Content-Type: application/json)
- All responses are JSON
- Timestamps are ISO 8601 UTC (
2024-01-15T10:30:00Z)
- UUIDs are lowercase with hyphens
Success:
{
"data": { ... },
"meta": {
"page": 1,
"per_page": 20,
"total": 142
}
}
Error:
{
"error": {
"code": "ROOM_NOT_FOUND",
"message": "Room with ID abc123 does not exist or you do not have access.",
"status": 404
}
}
Rate limiting
| Scope | Limit |
|---|
| Per token | 1000 requests / minute |
| File upload | 100 MB / request |
| Bulk operations | 100 items / request |
Rate limit headers are returned on every response:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1705316400
List endpoints support cursor-based pagination:
GET /api/v1/rooms?page=2&per_page=20
SDKs
Official SDKs are in development. In the meantime, the API is fully usable with any HTTP client. Examples in this reference use curl.
Contact hello@quelden.com if you need SDK support prioritised for a specific language.