---
title: "Search Nodes"
method: GET
path: "/agent-knowledge/search"
tags: ["agent-knowledge"]
---

# Search Nodes

`GET /agent-knowledge/search`

## 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/search`
- Auth: none declared

## Query parameters

- `query` string, required
- `page` integer
- `page_size` integer
- `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.

## Response `200`

Successful Response

- SearchAgentKnowledgeNodesResponse
  - `nodes` AgentKnowledgeFileNodeResponse[], required
    - `kind` 'file'
    - `id` string, required
    - `filePath` string, required
    - `parentPath` string, required
    - `name` string, required
    - `extension` string, nullable
    - `sizeBytes` integer, required
    - `entryKind` string, required
    - `categoryLabel` string, required
    - `sourceLabel` string, required
    - `commentCount` integer
    - `createdByUserId` string, nullable
    - `createdBy` AgentKnowledgeActorResponse
      - `userId` string, required
      - `displayName` string, nullable
      - `email` string, nullable
      - `avatarUrl` string, nullable
    - `isUserVisible` boolean, required
    - `sourceSessions` AgentKnowledgeSourceSessionResponse[]
      - `sessionId` string, required
      - `sessionTitle` string, nullable
      - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, required
  - `page` integer, required
  - `pageSize` integer, required
  - `hasMore` boolean, required
  - `query` string, required

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-09-10** `47dcc19b4add`: 1 info
  - added the optional property `nodes/items/sourceSessions` to the response with the `200` status
- **2026-09-09** `50f9ba1b135c`: 1 breaking, 16 info
  - the `nodes/items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `nodes/items/commentCount` to the response with the `200` status
  - added the optional property `nodes/items/createdBy` to the response with the `200` status
  - added the optional property `nodes/items/createdByUserId` to the response with the `200` status
  - …13 more
- **2026-08-20** `e0a48df02b41`: 2 info
  - added the new optional `query` request parameter `include_hidden`
  - added the required property `nodes/items/anyOf[subschema #2: AgentKnowledgeFileNodeResponse]/isUserVisible` to the response with the `200` status

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/agent-knowledge/search/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)