FruxonDocs
ApiKnowledge bases

Lists consolidation runs over a knowledge base, newest first.

Every pass ever queued over the knowledge base — manual and scheduled — with its status and, once completed, its report. The options each pass ran with (threshold, cluster size, recent-write window, report-only) are recorded on the run, so a report always reads against what produced it.

GET
/v1/tenants/{tenant}/knowledgeBases/{knowledgeBase}/consolidations

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

knowledgeBase*string

The knowledge base id.

Formatuuid
tenant*string

The tenant identifier

Query Parameters

PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/knowledgeBases/497f6eca-6276-4993-bfeb-53cbbbba6f08/consolidations"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "knowledgeBaseId": "00000000-0000-0000-0000-000000000000",
      "status": "QUEUED",
      "trigger": "MANUAL",
      "consolidationPolicyVersion": 0,
      "consolidationCadence": "MANUAL",
      "consolidationMode": "REPORT_ONLY",
      "requestedBy": "string",
      "reportOnly": false,
      "reportOnlyReason": "string",
      "similarityThreshold": 0,
      "maxClusterSize": 0,
      "recentWriteWindowMinutes": 0,
      "startedAt": 0,
      "completedAt": 0,
      "error": "string",
      "report": {
        "version": 0,
        "knowledgeBaseId": "00000000-0000-0000-0000-000000000000",
        "reportOnly": false,
        "consolidatorAgentId": "string",
        "similarityThreshold": 0,
        "maxClusterSize": 0,
        "recentWriteWindowMinutes": 0,
        "documentsConsidered": 0,
        "documentsSkippedAsRecentlyModified": 0,
        "embeddingsComputed": 0,
        "embeddingsReused": 0,
        "embeddingTokens": 0,
        "embeddingModel": "string",
        "clusters": [],
        "clustersFound": 0,
        "clustersMerged": 0,
        "clustersKeptSeparate": 0,
        "clustersFailed": 0,
        "clustersRelated": 0,
        "documentsArchived": 0
      },
      "createdAt": 0,
      "modifiedAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}