FruxonDocs
ApiKnowledge bases

Lists the agents whose live revision attaches the knowledge base, with their production runs and searches.

An agent attaches the base when a step of the revision it runs names the base, names its backing asset, or takes every asset of a revision that attaches it — directly, in an embedded sub-agent, or in an agent a Workflow runs by reference. Draft and undeployed revisions do not count. For each agent: completed production runs and searches of this base in the window, the latest search still kept, and the same two counts for its live revision alone. `attachedButNotSearching` is set when the live revision handled at least `notSearchingMinRuns` runs and none of them searched this base. Searches are recorded from 15 October 2026 and kept 90 days at most, and no longer than the workspace keeps its runs, so a window reaching further back is counted from `countedFromMs`, runs included. Only agents you can open are named; the rest are counted in `otherAgents`.

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

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

from?integer

Window start as Unix milliseconds (inclusive). Defaults to 30 days before to.

Formatint64
to?integer

Window end as Unix milliseconds (exclusive). Defaults to now.

Formatint64

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/knowledgeBases/497f6eca-6276-4993-bfeb-53cbbbba6f08/agents"
{
  "knowledgeBaseId": "00000000-0000-0000-0000-000000000000",
  "window": {
    "fromMs": 0,
    "toMs": 0
  },
  "countedFromMs": 0,
  "notSearchingMinRuns": 0,
  "agents": [
    {
      "agentId": "string",
      "displayName": "string",
      "runnableType": "AGENT",
      "enabled": false,
      "liveRevision": 0,
      "attachedVia": [
        "UNSPECIFIED"
      ],
      "runs": 0,
      "searches": 0,
      "lastSearchedAt": 0,
      "liveRevisionRuns": 0,
      "liveRevisionSearches": 0,
      "attachedButNotSearching": false
    }
  ],
  "otherAgents": {
    "count": 0
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}