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

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

## Changes

> 23 revisions in range; 6 not diffed, 2 could not be searched.

- **2026-08-20** `e0a48df02b41` — 2 info
  - added the new optional `query` request parameter `include_hidden`
  - added the required property `windows/items/oneOf[subschema #2: AgentKnowledgeNodeWindowResponse]/nodes/items/oneOf[subschema #2: AgentKnowledgeFileWindowNodeResponse]/isUserVisible` to the response with the `200` status

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/agent-knowledge/node-windows/post.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/8e5040513836/schema)