Quellen

Eine Quelle synchronisiert eine App in einen Namespace: Neue und geänderte Datensätze werden geschrieben, gelöschte werden gelöscht. Quellen benötigen einen Schlüssel mit Vollzugriff; für einen Bucket siehe Google Cloud Storage.

Eine Quelle verbinden

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

Leiten Sie den Eigentümer der App zu connect_url weiter (7 Tage gültig); die erste Synchronisierung startet, sobald er sich verbindet.

Option	Typ	Funktion
`type`	string, erforderlich	Die App, aus der Liste
`namespace`	string, erforderlich	Der Namespace, in den synchronisiert wird
`name`	string	Ein Anzeigename, bis zu 100 Zeichen
`redirect_url`	string	Wohin der Nutzer nach dem Verbinden geleitet wird
`sync_interval_s`	integer	Sekunden zwischen Synchronisierungen, 300 bis 2.592.000 (30 Tage); ohne Angabe wählt Conare einen Wert
`config`	object	Für Apps, die sich mit einem Schlüssel verbinden (Twenty, Granola, GitHub): `api_key` sowie `base_url` für ein selbst gehostetes Twenty; diese synchronisieren sofort, ohne `connect_url`

Um die Apps Ihrer Nutzer zu verbinden, geben Sie jedem Nutzer einen Namespace, etwa user-42. Vollständiges Schema: Eine Quelle verbinden.

Synchronisierte Dokumente


Id	`<source id>:<schema>:<record key>`
Metadaten	`source`, `source_id`, `schema`, `title` sowie `url`, `author`, `created_at`, `updated_at`, wenn der Datensatz sie hat
Eine Quelle durchsuchen	Filtern nach `source_id`

Eine Quelle abrufen

GET /sources/:id

curl

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

Feld	Bedeutung
`id`, `type`, `name`, `namespace`	Wie verbunden
`status`	`connecting` (wartet auf Anmeldung), `syncing`, `ready` oder `error`
`error`	Was fehlgeschlagen ist, oder `null`
`documents`	Bisher synchronisierte Dokumente
`progress`	Während der Synchronisierung die bisherigen `records_pulled`
`created_at`, `last_synced_at`, `next_sync_at`	Wann sie verbunden wurde, zuletzt synchronisiert hat und als Nächstes synchronisiert
`sync_interval_s`, `sync_interval_auto`	Sekunden zwischen Synchronisierungen und ob Conare sie wählt
`cost`	Was eine Synchronisierung liest und was jede Synchronisierungsfrequenz pro Monat kostet

Vollständiges Schema: Eine Quelle abrufen.

Quellen auflisten

GET /sources Gibt sources zurück, jeweils so, wie Get sie liefert; eine Quelle mit einem kind, etwa files oder gcs, hat stattdessen ein sync-Objekt.

Option	Typ	Funktion
`namespace`, `user`, `type`	string	Nur Quellen, deren Feld dem Wert entspricht, etwa `?namespace=crm&type=hubspot`

Vollständiges Schema: Quellen auflisten.

Jetzt synchronisieren

POST /sources/:id/sync Startet innerhalb von Sekunden eine Synchronisierung und gibt die Quelle zurück; eine Quelle im Status connecting gibt 409 conflict zurück.

Option	Typ	Funktion
`full`	boolean, Standard `false`	Alles erneut lesen, nicht nur Änderungen (Gmail, Twenty, Granola, GitHub); eine vollständige Gmail-Synchronisierung wird wie eine erste Synchronisierung abgerechnet, und `resync` weist darauf hin

Vollständiges Schema: Eine Quelle jetzt synchronisieren.

Das Synchronisierungsintervall ändern

PATCH /sources/:id

Option	Typ	Funktion
`sync_interval_s`	integer oder null	300 bis 2.592.000 Sekunden; mit `null` wählt Conare

Gibt die Quelle zurück. Vollständiges Schema: Festlegen, wie oft eine Quelle synchronisiert.

Eine Quelle trennen

DELETE /sources/:id Beendet die Synchronisierung und gibt { "deleted": true } zurück.

Option	Typ	Funktion
`delete_documents`	boolean, Standard `false`	Auch die synchronisierten Dokumente löschen

Vollständiges Schema: Eine Quelle trennen.

Die Apps auflisten

GET /sources/types

Response

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

Jede hat den type zum Verbinden, ihren name und logo_url sowie auth: "api_key" für Apps, die sich mit config verbinden.
partial ist true, wenn nur diese Apps aufgelistet werden konnten: Versuchen Sie es später erneut.

Vollständiges Schema: Quelltypen auflisten.

Erste Schritte

Grundlagen

Dateien

Synchronisierung

Modelle

Tools

Eine Quelle verbinden

Synchronisierte Dokumente

Eine Quelle abrufen

Quellen auflisten

Jetzt synchronisieren

Das Synchronisierungsintervall ändern

Eine Quelle trennen

Die Apps auflisten

​Eine Quelle verbinden

​Synchronisierte Dokumente

​Eine Quelle abrufen

​Quellen auflisten

​Jetzt synchronisieren

​Das Synchronisierungsintervall ändern

​Eine Quelle trennen

​Die Apps auflisten

Eine Quelle verbinden

Synchronisierte Dokumente

Eine Quelle abrufen

Quellen auflisten

Jetzt synchronisieren

Das Synchronisierungsintervall ändern

Eine Quelle trennen

Die Apps auflisten