---
title: "List folder children"
method: GET
path: "/folders/{folderId}/children"
tags: ["Folders"]
---

# List folder children

`GET /folders/{folderId}/children`

Returns the direct child folders of a folder. Subfolders the caller cannot access — but manages the parent of — are returned as opaque ids in `restrictedFolderIds`.

## Path parameters

- `folderId` string, required

## Query parameters

- `limit` integer
- `pageToken` string

## Response `200`

List of child folders.

- FolderChildList — List of a folder's direct children.
  - `items` FolderChild[], required — Direct children of the folder, both accessible and restricted, ordered and paged together. Pagination is driven by `nextPageToken`, so a page may contain fewer than `limit` accessible folders when restricted children take slots.
    - `id` string, required — ID of the Superhuman Docs folder.
    - `type` 'folder', required — The type of this resource.
    - `visibility` 'visible' | 'restricted', required — Whether the caller can access a folder returned in a children listing.
    - `name` string — The name of the folder. Absent for `restricted` children.
    - `browserLink` string, url — Browser-friendly link to the folder. Absent for `restricted` children.
    - `description` string — The description of the folder.
    - `iconColor` 'DARK_BLUE' | 'DARK_YELLOW' | 'DARK_PURPLE' | 'DARK_PINK' | 'DARK_ORANGE' | 'DARK_GREEN' | 'DARK_RED' | 'DARK_GRAY' | 'LIGHT_BLUE' | 'LIGHT_YELLOW' | 'LIGHT_PURPLE' | 'LIGHT_PINK' | 'LIGHT_ORANGE' | 'LIGHT_GREEN' | 'LIGHT_RED' | 'LIGHT_GRAY' — Color scheme for folder icons.
    - `createdAt` string, date-time — Timestamp for when the folder was created.
    - `canEdit` boolean — Whether the folder settings can be edited.
    - `workspace` WorkspaceReference — Reference to a Superhuman Docs workspace.
      - `id` string, required — ID of the Superhuman Docs workspace.
      - `type` 'workspace', required — The type of this resource.
      - `organizationId` string — ID of the organization bound to this workspace, if any.
      - `browserLink` string, url, required — Browser-friendly link to the Superhuman Docs workspace.
      - `name` string — Name of the workspace; included if the user has access to the workspace.
  - `href` string, url — API link to these results.
  - `nextPageToken` string — If specified, an opaque token used to fetch the next page of results.
  - `nextPageLink` string, url — If specified, a link that can be used to fetch the next page of results.

## Other responses

- `400` — The request parameters did not conform to expectations.
- `401` — The API token is invalid or has expired.
- `403` — The API token does not grant access to this resource.
- `404` — The resource could not be located with the current API token.
- `429` — The client has sent too many requests.

## Changes

- **2026-09-03** `cfcd32919f0e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/coda/apis/superhuman-docs-api/changes/folders/:folderId/children/get.md)

---

[API](https://skmtc.dev/coda/apis/superhuman-docs-api.md) · [All operations](https://skmtc.dev/coda/apis/superhuman-docs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coda/apis/superhuman-docs-api/revisions/56e839a06277?raw)