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

# List folders

> List media library folders for your workspaces (optional filters)

## List folders

Returns folders from every workspace you can access, unless you narrow with query parameters.

### Query parameters

* **`workspace_id`** - only folders in that workspace (must be one of your active workspaces).
* **`root=true`** - only top-level folders (`parent_id` is null).
* **`parent_id`** - only direct children of that folder (folder must belong to a workspace you can access).

Requires the **`posts`** token ability (same as media upload).

### Request

<RequestExample>
  ```bash theme={null}
  curl -G "https://postsyncer.com/api/v1/folders" \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    --data-urlencode "workspace_id=12" \
    --data-urlencode "root=true"
  ```
</RequestExample>

### See also

<Card title="Create folder" icon="plus" href="/api-reference/folders/create" />