---
title: "List folders"
method: GET
path: "/folders"
tags: ["Folders"]
---

# List folders

`GET /folders`

Returns a list of folders the user has access to.

## Query parameters

- `workspaceId` string
- `isStarred` boolean
- `limit` integer
- `pageToken` string

## Response `200`

List of folders.

- FolderList — List of folders.
  - `items` Folder[], required
    - `id` string, required — ID of the Superhuman Docs folder.
    - `type` 'folder', required — The type of this resource.
    - `name` string, required — The name of the folder.
    - `browserLink` string, url, required — Browser-friendly link to the folder.
    - `description` string — The description of the folder.
    - `icon` Icon — Info about the icon.
      - `name` string, required — Name of the icon.
      - `type` string, required — MIME type of the icon
      - `browserLink` string, url, required — Browser-friendly link to an icon.
    - `createdAt` string, date-time — Timestamp for when the folder was created.
    - `canEdit` boolean — Whether the folder settings can be edited. E.g., some folder types (like personal folders - "My Docs") cannot be edited.
    - `workspace` WorkspaceReference, required — 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.
- `429` — The client has sent too many requests.

---

[API](https://skmtc.net/coda/apis/superhuman-docs-api.md) · [All operations](https://skmtc.net/coda/apis/superhuman-docs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coda/superhuman-docs-api/versions/c65a8418f3c8/schema)