​
Overview

The CalStudio API enables you to programmatically create, manage, and interact with your custom AI apps. Whether you’re integrating CalStudio into your existing workflow or building advanced automation, our RESTful API provides comprehensive access to platform features.

​
Key Capabilities

  • App Management: Create, update, and delete AI apps
  • User Analytics: Access detailed usage statistics and chat history
  • Webhook Integration: Receive real-time notifications for app events
  • Custom Deployments: Manage white-label configurations
  • Payment Processing: Handle subscriptions and credit purchases

​
Base URL

https://api.calstudio.com/v1

​
API Versioning

We use URL-based versioning to ensure backward compatibility. The current version is v1. We’ll notify you well in advance of any breaking changes through our changelog.

​
Authentication

CalStudio uses API keys for authentication. Include your API key in the Authorization header of every request: 
curl -X GET https://api.calstudio.com/v1/apps \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Getting Your API Key

  1. Log in to your CalStudio dashboard
  2. Navigate to Account Settings → API Keys
  3. Click Generate New Key
  4. Store your key securely - it won’t be shown again
Keep your API keys secure and never expose them in client-side code or public repositories. Treat them like passwords.

​
Rate Limits

API requests are subject to rate limiting to ensure platform stability:
PlanRequests per MinuteRequests per Day
Free601,000
Lite1205,000
Pro30025,000
Pro Plus600100,000
Rate limit headers are included in all responses: 
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1640995200

​
Error Handling

CalStudio API uses standard HTTP status codes and returns detailed error messages: 
{
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API key is invalid or expired",
    "request_id": "req_123abc"
  }
}

​
Common Error Codes

Status CodeDescription
400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
403Forbidden - Insufficient permissions
404Not Found - Resource doesn’t exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Something went wrong

​
Quick Start

Ready to make your first API call? Check out these common use cases:

List Your Apps

Retrieve all AI apps in your account

Create an App

Programmatically create new AI apps

Configure Webhooks

Set up real-time event notifications

Delete an App

Remove AI apps from your account