Sources

Une source synchronise une application dans un namespace : les enregistrements nouveaux et modifiés sont écrits, les supprimés sont supprimés. Les sources exigent une clé Full access ; pour un bucket, voir Google Cloud Storage.

Connecter une source

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://..."
}

Envoyez le propriétaire de l’application vers connect_url (valide 7 jours) ; la première synchronisation démarre dès sa connexion.

Option	Type	Rôle
`type`	string, obligatoire	L’application, issue de la liste
`namespace`	string, obligatoire	Le namespace à alimenter
`name`	string	Un nom d’affichage, jusqu’à 100 caractères
`redirect_url`	string	Où renvoyer l’utilisateur après sa connexion
`sync_interval_s`	integer	Secondes entre deux synchronisations, de 300 à 2 592 000 (30 jours) ; Conare en choisit une si omis
`config`	object	Pour les applications qui se connectent par clé (Twenty, Granola, GitHub) : `api_key`, et `base_url` pour un Twenty auto-hébergé ; elles se synchronisent aussitôt, sans `connect_url`

Pour connecter les applications de vos utilisateurs, donnez à chacun un namespace, comme user-42. Schéma complet : Connecter une source.

Documents synchronisés


Id	`<source id>:<schema>:<record key>`
Métadonnées	`source`, `source_id`, `schema`, `title`, ainsi que `url`, `author`, `created_at`, `updated_at` si l’enregistrement les possède
Rechercher dans une source	Filtrez sur `source_id`

Obtenir une source

GET /sources/:id

curl

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

Champ	Signification
`id`, `type`, `name`, `namespace`	Tels que connectés
`status`	`connecting` (en attente de connexion), `syncing`, `ready` ou `error`
`error`	Ce qui a échoué, ou `null`
`documents`	Documents synchronisés
`progress`	Pendant la synchronisation, `records_pulled` jusqu’ici
`created_at`, `last_synced_at`, `next_sync_at`	Date de connexion, de dernière et de prochaine synchronisation
`sync_interval_s`, `sync_interval_auto`	Secondes entre deux synchronisations, et si Conare les choisit
`cost`	Ce qu’une synchronisation lit, et le coût mensuel de chaque fréquence

Schéma complet : Obtenir une source.

Lister les sources

GET /sources Renvoie sources, chacune telle que Get la renvoie ; une source avec un kind, comme files ou gcs, a plutôt un objet sync.

Option	Type	Rôle
`namespace`, `user`, `type`	string	Seulement les sources dont le champ vaut cette valeur, comme `?namespace=crm&type=hubspot`

Schéma complet : Lister les sources.

Synchroniser maintenant

POST /sources/:id/sync Lance une synchronisation en quelques secondes et renvoie la source ; une source encore connecting renvoie 409 conflict.

Option	Type	Rôle
`full`	boolean, `false` par défaut	Tout relire, pas seulement les changements (Gmail, Twenty, Granola, GitHub) ; une synchronisation Gmail complète est facturée comme une première, et `resync` l’indique

Schéma complet : Synchroniser une source maintenant.

Modifier l’intervalle de synchronisation

PATCH /sources/:id

Option	Type	Rôle
`sync_interval_s`	integer ou null	De 300 à 2 592 000 secondes ; `null` laisse Conare choisir

Renvoie la source. Schéma complet : Définir la fréquence de synchronisation.

Déconnecter une source

DELETE /sources/:id Arrête la synchronisation et renvoie { "deleted": true }.

Option	Type	Rôle
`delete_documents`	boolean, `false` par défaut	Supprimer aussi les documents synchronisés

Schéma complet : Déconnecter une source.

Lister les applications

GET /sources/types

Response

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

Chacune a le type à connecter, son name et son logo_url, et auth: "api_key" pour les applications qui se connectent avec config.
partial vaut true quand seules ces applications ont pu être listées : réessayez plus tard.

Schéma complet : Lister les types de sources.

Premiers pas

Essentiel

Fichiers

Synchronisation

Modèles

Outils

Connecter une source

Documents synchronisés

Obtenir une source

Lister les sources

Synchroniser maintenant

Modifier l’intervalle de synchronisation

Déconnecter une source

Lister les applications

​Connecter une source

​Documents synchronisés

​Obtenir une source

​Lister les sources

​Synchroniser maintenant

​Modifier l’intervalle de synchronisation

​Déconnecter une source

​Lister les applications

Connecter une source

Documents synchronisés

Obtenir une source

Lister les sources

Synchroniser maintenant

Modifier l’intervalle de synchronisation

Déconnecter une source

Lister les applications