---
title: "List folders for a connection"
method: GET
path: "/connections/{connection_id}/folders"
tags: ["Folders", "Folders"]
---

# List folders for a connection

`GET /connections/{connection_id}/folders`

List one level of folders from the user's connected source.

Returns folders decorated with their explicit folder policy (if any).
Use parent_id to drill into subfolders.

## Path parameters

- `connection_id` string, uuid, required

## Query parameters

- `parent_id` string, nullable — Parent folder ID. Omit for root-level folders.

## Response `200`

Successful Response

- FolderListResponse
  - `folders` FolderItem[], required — Folders at this level
    - `provider_folder_id` string, required — Folder ID from the source provider
    - `name` string, required — Display name of the folder
    - `parent_folder_id` string, nullable — Parent folder's provider ID
    - `has_children` boolean, required — Whether this folder may have subfolders
    - `policy` FolderPolicyInline
      - `id` string, uuid, required — Policy UUID
      - `sync_mode` 'sync' | 'skip' | 'manual', required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hyperspell/apis/hyperspell-api.md) · [All operations](https://skmtc.net/hyperspell/apis/hyperspell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperspell/hyperspell-api/revisions/5721acd588e6/schema)