---
title: "List storage directory"
method: GET
path: "/storage/list"
tags: ["storage"]
---

# List storage directory

`GET /storage/list`

Lists one level of files and folders in the business node's storage space. Page through with page_token; an empty next_page_token means the level is exhausted. Folder keys can repeat across pages and should be deduped client-side.

## Query parameters

- `business_node_id` string, required
- `path` string
- `page_token` string
- `page_size` integer

## Response `200`

OK

- ModelsStorageListResponse
  - `items` ModelsStorageItem[]
    - `contains_synced` boolean — normal folder with synced folder(s) beneath it
    - `content_type` string
    - `key` string
    - `last_modified` string
    - `name` string
    - `shared_root` boolean — folder has an active shared-storage share (owner-side badge)
    - `size` integer
    - `synced` boolean — item is a synced folder or inside one
    - `synced_root` boolean — item IS a synced folder
    - `type` string — "file" or "folder"
  - `next_page_token` string
  - `path` string
  - `path_shared` boolean — dir is a shared folder or inside one (owner badge)
  - `path_synced` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

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