x-cpod-domain: integrations
Integrations
External system connections, data source registry, and sync state tracking for monitoring cross-app data pipeline health.
Try in explorer
client.integrations.connections · client.integrations.dataSources · client.integrations.syncStateConnection
An external system connection (OAuth, API key, webhook).
REST path
/api/v1/integrations/connectionsOperations
listgetcreateupdatedeleteSDK
// list — returns only your records; add filters/search:
await client.integrations.connections.connections.list()
// create:
await client.integrations.connections.connections.create({
name: "example name",
provider: "example provider",
id: "rec_01HXEXAMPLE",
status: "active",
auth_type: "oauth2",
connected_at: "2026-01-01T00:00:00Z",
})| Field | Type | Description |
|---|---|---|
| id | uuid | — |
| name* | string | — |
| provider* | string | — |
| status | enum | —activeinactiveerrorpending |
| auth_type | enum | —oauth2api_keybasicwebhook |
| connected_at | date-time | — |
IntegrationDataSource
A registered data source with metadata.
REST path
/api/v1/integrations/data-sourcesOperations
listgetcreateupdatedeleteSDK
// list — returns only your records; add filters/search:
await client.integrations.connections.dataSources.list()
// create:
await client.integrations.connections.dataSources.create({
name: "example name",
id: "rec_01HXEXAMPLE",
connection_id: "connection_01HXEXAMPLE",
type: "example type",
last_synced_at: "2026-01-01T00:00:00Z",
})| Field | Type | Description |
|---|---|---|
| id | uuid | — |
| connection_id | uuid→Connection | — |
| name* | string | — |
| type | string | — |
| schema | json | — |
| last_synced_at | date-time | — |
SyncState
Sync status and last-refresh timestamps for a data source.
REST path
/api/v1/integrations/sync-stateOperations
listgetcreateupdateSDK
// list — returns only your records; add filters/search:
await client.integrations.connections.syncState.list()
// create:
await client.integrations.connections.syncState.create({
id: "rec_01HXEXAMPLE",
data_source_id: "integrationdatasource_01HXEXAMPLE",
status: "idle",
last_refresh: "2026-01-01T00:00:00Z",
records_synced: 42,
error_message: "example error_message",
})| Field | Type | Description |
|---|---|---|
| id | uuid | — |
| data_source_id | uuid→IntegrationDataSource | — |
| status | enum | —idlesyncingsuccessfailed |
| last_refresh | date-time | — |
| records_synced | integer | — |
| error_message | string | — |