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

# List folders

`GET /v2/folders`

## Request

- Base URL: `https://api.storydoc.com`
- URL: `https://api.storydoc.com/v2/folders`
- Auth: HTTP bearer

The story folders the API key's creator can open - the folder tree they see in the dashboard (an administrator's key sees every folder) - with each folder's path and who can open it, in the same shape as a version's `folder`. A parent they cannot open is left out of `path`, and the folder's `parentId` is then null. Use it to pick a `folderId` for GET /v2/versions. A key scoped to one story lists only the folder that story is in (none if it sits at the root).

## Response `200`

The folders

- FolderListResponse
  - `data` Folder[]
    - `id` string
    - `name` string
    - `path` string[]: Folder names from the root down
    - `parentId` string, nullable: The parent folder's id; null at the top level
    - `sharedWithEveryone` boolean: True when everyone in your organization can open the folder (the app's "Share with everyone in your organization"). This is about your team, not the public.
    - `members` object[]: Who can open the folder when it is not shared with everyone; empty when it is. Access is set per folder (a parent's members do not carry over), and organization administrators can open every folder without being listed.
      - `name` string, nullable
      - `email` string, nullable
      - `role` 'Owner' | 'Editor', nullable

## Other responses

- `403`: Authentication failed, the member who created the key has left the organization, or a legacy org token has been replaced by a newer one
- `429`: Too many requests
- `500`: Internal server error

---

[API](https://skmtc.dev/storydoc/apis/storydoc-api-v2.md) - [All operations](https://skmtc.dev/storydoc/apis/storydoc-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/storydoc/apis/storydoc-api-v2/revisions/366e7d124e9e?raw)