---
title: "Get Stats"
method: GET
path: "/agent-knowledge/stats"
tags: ["agent-knowledge"]
---

# Get Stats

`GET /agent-knowledge/stats`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/agent-knowledge/stats`
- Auth: none declared

## Query parameters

- `include_hidden` boolean: Include files and directories hidden from customers. Platform admins default to true so they can find and unhide them. Org members always receive the customer-visible tree, even when this flag is set.
- `query` string, nullable: When set, totalEntries and each root fileCount include only files matching this search, using the same path/name/summary match as GET /agent-knowledge/search.

## Response `200`

Successful Response

- AgentKnowledgeSummaryStatsResponse
  - `totalEntries` integer, required
  - `contributorCount` integer, required
  - `roots` AgentKnowledgeRootStatsResponse[], required
    - `path` 'ai_generated' | 'user_generated' | 'memories' | 'skills', required
    - `fileCount` integer, required

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-09-11** `c5e1ea955e81`: 2 info
  - added the new optional `query` request parameter `query`
  - added the required property `roots` to the response with the `200` status
- **2026-08-20** `e0a48df02b41`: 2 info
  - added the new optional `query` request parameter `include_hidden`
  - added the non-success response with the status `422`

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/agent-knowledge/stats/get.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)