Calabi Connect API
Programmatically manage your data pipelines — create sources and destinations, trigger syncs, monitor jobs, and automate your data stack.
Base URL
https://api.calabi.ai/v1
Authentication
All API requests require a Bearer token in the Authorization header.
Authorization: Bearer <your-api-key>
Generate an API key from Calabi Connect → Settings → API Keys.
Resources
| Resource | Description |
|---|---|
| Sources | Manage data source connections |
| Destinations | Manage data destination connections |
| Connections | Configure and control sync pipelines |
| Jobs | Trigger and monitor sync jobs |
| Workspaces | Manage workspaces and organizations |
Quick Start
1. List all sources
curl -X GET "https://api.calabi.ai/v1/sources" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json"
2. Create a source
curl -X POST "https://api.calabi.ai/v1/sources" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Postgres Source",
"definitionId": "decd338e-5647-4c0b-adf4-da0e75f5a750",
"workspaceId": "YOUR_WORKSPACE_ID",
"connectionConfiguration": {
"host": "localhost",
"port": 5432,
"database": "mydb",
"username": "user",
"password": "secret"
}
}'
3. Trigger a sync job
curl -X POST "https://api.calabi.ai/v1/jobs" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connectionId": "YOUR_CONNECTION_ID",
"jobType": "sync"
}'
Rate Limits
| Plan | Requests/minute |
|---|---|
| Starter | 60 |
| Professional | 300 |
| Enterprise | 1,000 |
SDKs
| Language | Package |
|---|---|
| Python | pip install calabi-connect-api |
| TypeScript | npm install @calabi/connect-sdk |
| Java | com.calabi:connect-api |
| Go | github.com/calabi/connect-api-go |
tip
Use the Connections resource to link a source to a destination and configure your sync schedule, field selections, and data transformations.