List knowledge base source items
Lists the items discovered in a source (files, webpages, or text) with their type and provider metadata.
Authorization
personalAccessToken Personal Access Token of a Dynamiq user — the only credential accepted by the management API (api.*). Prefix dyn_pat_ (legacy uak_ tokens still authenticate). Send as Authorization: Bearer <token>.
In: header
Path Parameters
Knowledge base source UUID.
Query Parameters
Page number (1-based).
Number of items per page. Values below the minimum or above the maximum are clamped to the nearest bound.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/knowledgebase-sources/497f6eca-6276-4993-bfeb-53cbbbba6f08/items"{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"type": "file",
"source_id": "ae50a35c-df42-4eff-ba26-f8bc28d2af81",
"source_sync_id": "54cd5011-4443-47bf-8b57-a64fcea34e39",
"metadata": {},
"source": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"provider": "google_drive",
"status": "active"
}
}
],
"pagination": {
"page": 0,
"page_size": 0,
"page_count": 0,
"total_count": 0
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized"
}
}{
"error": {
"code": "not_found",
"message": "Not Found"
}
}Trigger a knowledge base source sync
Starts a synchronization run that pulls the latest content from the source and ingests new or changed items. The sync runs asynchronously; track progress via the syncs endpoint.
Pause a knowledge base source
Pauses automatic synchronization for a source. Its status becomes `paused` and scheduled syncs are suspended until resumed.