---
title: "List objects in a connected bucket"
method: GET
path: "/storage/{id}/objects"
tags: ["Storage"]
---

# List objects in a connected bucket

`GET /storage/{id}/objects`

One page of folders and files directly under `prefix` (empty for the root). Up to 1000 keys per page; pass `cursor` for the next page. The bucket's own listing permission applies.

## Path parameters

- `id` string, required

## Query parameters

- `prefix` string
- `cursor` string
- `limit` integer

## Response `200`

A page

- object
  - `data` object, required
    - `folders` string[], required
    - `objects` object[], required
      - `key` string, required
      - `size` integer, required
      - `lastModified` number, nullable, required
    - `cursor` string, nullable, required

## Other responses

- `400` — The connection cannot list, or the prefix is not a folder
- `401` — Unauthorized
- `403` — Missing scope or role
- `404` — Not found
- `502` — The bucket did not answer with a listing

## Changes

- **2026-09-13** `e2df91eff7a2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rendobar/apis/rendobar-api/changes/storage/:id/objects/get.md)

---

[API](https://skmtc.dev/rendobar/apis/rendobar-api.md) · [All operations](https://skmtc.dev/rendobar/apis/rendobar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rendobar/apis/rendobar-api/revisions/421a5a241a64?raw)