# List folders

**GET /v2/folders**

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


## Servers
- Production API server: https://api.storydoc.com (Production API server)


## Authentication methods
- Bearer auth


## Parameters




## Responses
### 200
The folders

#### Body: application/json (object)
- **data** (array[object])


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

#### Body: application/json (object)
- **error** (string)

- **code** (string)
  `VARIABLES_PLAN_REQUIRED` when the story uses variables above the account's plan; absent for authentication failures.

- **requiredPlan** (string)
  With `VARIABLES_PLAN_REQUIRED`: the lowest plan that covers every blocked variable.

- **variables** (array[object])
  With `VARIABLES_PLAN_REQUIRED`: the blocked variables and the plan each needs.


### 429
Too many requests

#### Body: application/json (object)
- **error** (string)


### 500
Internal server error

#### Body: application/json (object)
- **error** (string)

- **errorId** (string)



[Powered by Bump.sh](https://bump.sh)