---
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. Defaults to true so platform admins can find and unhide them. Set false to preview the customer-visible tree.

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

---

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