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

# Search Nodes

`GET /agent-knowledge/search`

## 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` union[], required
    - union
      - AgentKnowledgeDirectoryResponse
        - `kind` 'directory'
        - `id` string, nullable
        - `path` string, required
        - `parentPath` string, required
        - `name` string, required
        - `directoryKind` string, nullable
        - `status` string, nullable
        - `isUserVisible` boolean, required
        - `fileCount` integer, nullable
        - `directoryCount` integer, nullable
        - `categoryLabel` string, nullable
        - `commentCount` integer
        - `updatedAt` string, date-time, nullable
      - AgentKnowledgeFileNodeResponse
        - `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
        - `updatedAt` string, date-time, required
  - `page` integer, required
  - `pageSize` integer, required
  - `hasMore` boolean, required
  - `query` string, required

## Other responses

- `422` — Validation Error

## Changes

> 22 revisions in range; 6 not diffed.

- **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

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/agent-knowledge/search/get.md)

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/01ca496f3b4f/schema)