Skip to main content

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.

Request format

  • 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

Response format

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

ScopeLimit
Per token1000 requests / minute
File upload100 MB / request
Bulk operations100 items / request
Rate limit headers are returned on every response:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1705316400

Pagination

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.