Skip to main content

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

ResourceDescription
SourcesManage data source connections
DestinationsManage data destination connections
ConnectionsConfigure and control sync pipelines
JobsTrigger and monitor sync jobs
WorkspacesManage 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

PlanRequests/minute
Starter60
Professional300
Enterprise1,000

SDKs

LanguagePackage
Pythonpip install calabi-connect-api
TypeScriptnpm install @calabi/connect-sdk
Javacom.calabi:connect-api
Gogithub.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.