Skip to content
TriedDocs
Knowledge bases

List knowledge base syncs

List the Google Drive, OneDrive and Notion connections of a knowledge base.

GEThttps://api.tried.com.au/list-knowledge-base-syncs/{knowledge_base_id}

Needs keys Returns the synced source connections of a knowledge base, oldest first. Connections without a provider token run in mock mode and show mock: true.

Request#

Path parameter Type Required Description
knowledge_base_id string Yes The knowledge base ID, starting with knowledge_base_.

Example request#

curl https://api.tried.com.au/list-knowledge-base-syncs/knowledge_base_9f060d81a4d8df9b04ca6d12 \
  -H "Authorization: Bearer $TRIED_API_KEY"
const res = await fetch(
  "https://api.tried.com.au/list-knowledge-base-syncs/knowledge_base_9f060d81a4d8df9b04ca6d12",
  { headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` } },
);
const syncs = await res.json();
import os, requests

res = requests.get(
    "https://api.tried.com.au/list-knowledge-base-syncs/knowledge_base_9f060d81a4d8df9b04ca6d12",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
syncs = res.json()

Response#

200 OK

[
  {
    "oauth": true,
    "oauth_expires_timestamp": 1760835600000,
    "sync_id": "kbsync_47800c505ee631a117973dcf",
    "knowledge_base_id": "knowledge_base_9f060d81a4d8df9b04ca6d12",
    "provider": "notion",
    "config": { "page_id": "1a2b3c4d5e6f47a8b9c0d1e2f3a4b5c6" },
    "status": "error",
    "error": "api.notion.com 404: {\"object\":\"error\",\"status\":404}",
    "last_synced_timestamp": 1760745600000,
    "document_count": 4,
    "mock": false
  }
]

Each item is the sync object described in Add synced source. An unknown knowledge base ID returns an empty array.

Errors#

Status When
401 Missing or invalid API key.
403 The key's IP allowlist or scopes reject the request. This route needs the kb scope.
429 Rate limit exceeded. See Rate limits.

See Errors for the body format.