---
title: "List Node Windows"
method: POST
path: "/agent-knowledge/node-windows"
tags: ["agent-knowledge"]
---

# List Node Windows

`POST /agent-knowledge/node-windows`

## Query parameters

- `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.

## Request body

- AgentKnowledgeNodeWindowsRequest
  - `windows` AgentKnowledgeNodeWindowRequest[], required
    - `afterCount` integer, nullable
    - `afterCursor` string, nullable
    - `anchorPath` string, nullable
    - `beforeCount` integer, nullable
    - `beforeCursor` string, nullable
    - `limit` integer, nullable
    - `parentPath` string, nullable
    - `windowId` string, nullable

## Response `200`

Successful Response

- AgentKnowledgeNodeWindowsResponse
  - `windows` AgentKnowledgeNodeWindowResultResponse[], required
    - union
      - AgentKnowledgeNodeWindowErrorResponse
        - `error` AgentKnowledgeNodeWindowErrorDetailResponse, required
          - `code` 'duplicate_window_id' | 'invalid_cursor' | 'invalid_window', required
          - `message` string, required
        - `parentPath` string, nullable, required
        - `status` 'error'
        - `windowId` string, nullable, required
      - AgentKnowledgeNodeWindowResponse
        - `anchorFound` boolean, nullable, required
        - `anchorIndex` integer, nullable, required
        - `nodes` AgentKnowledgeNodeWindowNodeResponse[], required
          - union
            - AgentKnowledgeDirectoryWindowNodeResponse
              - …
            - AgentKnowledgeFileWindowNodeResponse
              - …
        - `pageInfo` AgentKnowledgeNodeWindowPageInfoResponse, required
          - `endCursor` string, nullable, required
          - `hasNextPage` boolean, required
          - `hasPreviousPage` boolean, required
          - `startCursor` string, nullable, required
        - `parentPath` string, required
        - `status` 'ok'
        - `windowId` 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)