🅼 View as Markdown

Rate Limits ​

Rate limits control how many API requests you can make within a specific time period to ensure fair usage and system stability.

Overview ​

Rate Limits - All API endpoints have rate limits to prevent abuse and ensure reliable service for all users. Limits are applied per project and reset automatically after the time window.

Rate Limit Types ​

Read Operations ​

Limit: 1,000 requests per minute

Read operations retrieve data without modifying it:

  • db.find - Query documents
  • db.count - Count documents
  • file.get - Get file information
  • vdb.search - Search vectors
  • auth.verify_id_token - Verify tokens
  • auth.settings - Get auth settings

Write Operations ​

Limit: 500 requests per minute

Write operations create, update, or delete data:

  • db.insert - Insert documents
  • db.update - Update documents
  • db.upsert - Update or insert documents
  • db.delete - Delete documents
  • db.archive - Archive documents
  • db.restore - Restore documents
  • file.presign_upload - Upload files
  • file.update - Update file metadata
  • file.delete - Delete files
  • vdb.insert - Insert vectors
  • vdb.delete - Delete vectors
  • auth.signup - Register users
  • auth.signin - Sign in users
  • auth.update_profile - Update profile
  • auth.update_account - Update account
  • All baseai.* operations

Rate Limit Headers ​

Every API response includes rate limit information in the headers:

http
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1705651200

Headers:

  • X-RateLimit-Limit - Maximum requests allowed in the current window
  • X-RateLimit-Remaining - Requests remaining in the current window
  • X-RateLimit-Reset - Unix timestamp when the limit resets

Rate Limit Response ​

When you exceed the rate limit, the API returns a 429 status code:

json
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Try again in 45 seconds.",
    "details": {
      "limit": 1000,
      "remaining": 0,
      "reset_at": 1705651200,
      "retry_after": 45
    }
  }
}

Error fields:

  • limit - Maximum requests allowed
  • remaining - Requests remaining (0 when exceeded)
  • reset_at - Unix timestamp when limit resets
  • retry_after - Seconds to wait before retrying

Rate Limit by Plan ​

Rate limits may vary based on your subscription plan: Solo, Pro, Team, Enterprise.

Note: Actual limits for your project can be found in your Singlebase Console under Project Settings.

Support ​

If you consistently hit rate limits and need higher limits:

  1. Review your implementation for optimization opportunities
  2. Consider upgrading your plan
  3. Contact support for custom enterprise limits
  4. Monitor usage patterns in the Singlebase Console

For questions about rate limits or to request limit increases, visit Singlebase Console or contact support.