Sorgenti

Una sorgente sincronizza un’app in un namespace: i record nuovi e modificati vengono scritti, quelli eliminati vengono eliminati. Le sorgenti richiedono una chiave con accesso completo; per un bucket, consulta Google Cloud Storage.

Collegare una sorgente

POST /sources

curl https://api.conare.ai/sources \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "hubspot", "namespace": "crm", "redirect_url": "https://yourapp.com/settings"}'

const { source, connectUrl } = await conare.sources.connect({
  type: "hubspot",
  namespace: "crm",
  redirectUrl: "https://yourapp.com/settings",
});

Response

{
  "source": {
    "id": "src_1cff2c6ea888bbc8343b6e38",
    "type": "hubspot",
    "name": "HubSpot",
    "namespace": "crm",
    "status": "connecting",
    "error": null,
    "documents": 0,
    "last_synced_at": null,
    "created_at": "2026-10-21T21:40:39.704618Z",
    "sync_interval_s": null,
    "sync_interval_auto": true,
    "next_sync_at": null,
    "cost": { "rows_billed": true, "usd_per_million_rows": 100, "options": [ ... ] }
  },
  "connect_url": "https://..."
}

Invia il proprietario dell’app a connect_url (valido per 7 giorni); la prima sincronizzazione parte quando si collega.

Opzione	Tipo	Cosa fa
`type`	string, obbligatorio	L’app, dalla lista
`namespace`	string, obbligatorio	Il namespace in cui sincronizzare
`name`	string	Un nome visualizzato, fino a 100 caratteri
`redirect_url`	string	Dove inviare l’utente dopo il collegamento
`sync_interval_s`	integer	Secondi tra le sincronizzazioni, da 300 a 2.592.000 (30 giorni); se omesso lo sceglie Conare
`config`	object	Per le app che si collegano con una chiave (Twenty, Granola, GitHub): `api_key`, e `base_url` per un Twenty self-hosted; queste si sincronizzano subito, senza `connect_url`

Per collegare le app dei tuoi utenti, assegna a ciascuno un namespace, come user-42. Schema completo: Collegare una sorgente.

Documenti sincronizzati


Id	`<source id>:<schema>:<record key>`
Metadati	`source`, `source_id`, `schema`, `title`, e `url`, `author`, `created_at`, `updated_at` quando il record li ha
Cercare in una sorgente	Filtra su `source_id`

Ottenere una sorgente

GET /sources/:id

curl

curl https://api.conare.ai/sources/src_1cff2c6ea888bbc8343b6e38 \
  -H "Authorization: Bearer $CONARE_API_KEY"

Campo	Significato
`id`, `type`, `name`, `namespace`	Come al collegamento
`status`	`connecting` (in attesa dell’accesso), `syncing`, `ready` o `error`
`error`	Cosa non è andato a buon fine, oppure `null`
`documents`	Documenti sincronizzati
`progress`	Durante la sincronizzazione, `records_pulled` finora
`created_at`, `last_synced_at`, `next_sync_at`	Quando è stata collegata, l’ultima sincronizzazione e la prossima
`sync_interval_s`, `sync_interval_auto`	Secondi tra le sincronizzazioni, e se li sceglie Conare
`cost`	Cosa legge una sincronizzazione, e quanto costa al mese ogni frequenza

Schema completo: Ottenere una sorgente.

Elencare le sorgenti

GET /sources Restituisce sources, ciascuna come la restituisce Get; una sorgente con un kind, come files o gcs, ha invece un oggetto sync.

Opzione	Tipo	Cosa fa
`namespace`, `user`, `type`	string	Solo le sorgenti il cui campo è uguale al valore, come `?namespace=crm&type=hubspot`

Schema completo: Elencare le sorgenti.

Sincronizzare ora

POST /sources/:id/sync Avvia una sincronizzazione entro pochi secondi e restituisce la sorgente; una sorgente ancora connecting restituisce 409 conflict.

Opzione	Tipo	Cosa fa
`full`	boolean, predefinito `false`	Rilegge tutto, non solo le modifiche (Gmail, Twenty, Granola, GitHub); una sincronizzazione completa di Gmail è fatturata come la prima, e `resync` lo indica

Schema completo: Sincronizzare ora una sorgente.

Modificare l’intervallo di sincronizzazione

PATCH /sources/:id

Opzione	Tipo	Cosa fa
`sync_interval_s`	integer o null	Da 300 a 2.592.000 secondi; `null` lascia scegliere a Conare

Restituisce la sorgente. Schema completo: Impostare la frequenza di sincronizzazione.

Scollegare una sorgente

DELETE /sources/:id Interrompe la sincronizzazione e restituisce { "deleted": true }.

Opzione	Tipo	Cosa fa
`delete_documents`	boolean, predefinito `false`	Elimina anche i documenti sincronizzati

Schema completo: Scollegare una sorgente.

Elencare le app

GET /sources/types

Response

{
  "types": [
    { "type": "affinity", "name": "Affinity", "logo_url": "https://..." },
    { "type": "airtable", "name": "Airtable", "logo_url": "https://..." }
  ]
}

Ognuna ha il type da collegare, il suo name e logo_url, e auth: "api_key" per le app che si collegano con config.
partial è true quando è stato possibile elencare solo quelle app: riprova più tardi.

Schema completo: Elencare i tipi di sorgente.

Primi passi

Fondamenti

File

Sincronizzazione

Modelli

Strumenti

Collegare una sorgente

Documenti sincronizzati

Ottenere una sorgente

Elencare le sorgenti

Sincronizzare ora

Modificare l’intervallo di sincronizzazione

Scollegare una sorgente

Elencare le app

​Collegare una sorgente

​Documenti sincronizzati

​Ottenere una sorgente

​Elencare le sorgenti

​Sincronizzare ora

​Modificare l’intervallo di sincronizzazione

​Scollegare una sorgente

​Elencare le app

Collegare una sorgente

Documenti sincronizzati

Ottenere una sorgente

Elencare le sorgenti

Sincronizzare ora

Modificare l’intervallo di sincronizzazione

Scollegare una sorgente

Elencare le app