> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openinary.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Folders

> Get every folder path in storage, for building a folder picker

## Endpoint

```
GET /storage/folders
```

**Auth:** API Key required

## Response

```json theme={null}
{
  "folders": ["archive", "photos", "photos/2024"]
}
```

<ResponseField name="folders" type="string[]">
  Every folder path in storage, relative to the storage root, sorted alphabetically. Used to power "Move to" folder pickers.
</ResponseField>

## Example

```bash theme={null}
curl http://localhost:3000/storage/folders \
  -H "Authorization: Bearer <api_key>"
```

## Related

<CardGroup cols={2}>
  <Card title="Move File or Folder" icon="folder-tree" href="/api-reference/storage/move">
    Move a file or folder into one of these destinations.
  </Card>

  <Card title="List Storage" icon="folder-open" href="/api-reference/storage/list">
    Browse the full file and folder tree.
  </Card>
</CardGroup>