---
title: "List Nodes"
method: GET
path: "/agent-knowledge/nodes"
tags: ["agent-knowledge"]
---

# List Nodes

`GET /agent-knowledge/nodes`

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

## Query parameters

- `parent_path` string
- `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

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

## 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/anyOf[subschema #2: AgentKnowledgeFileNodeResponse]/sourceSessions` to the response with the `200` status
- **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/nodes/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)