---
title: "List Public Objects."
method: GET
path: "/v1/objects/list_public"
tags: ["objects"]
---

# List Public Objects.

`GET /v1/objects/list_public`

List all public Objects with pagination support.

## Query parameters

- `limit` integer
- `starting_after` string
- `name` string
- `content_type` 'unspecified' | 'text' | 'binary' | 'gzip' | 'tar' | 'tgz'
- `state` 'UPLOADING' | 'READ_ONLY' | 'DELETED' | 'ERROR'
- `search` string
- `include_total_count` boolean

## Response `200`

Successfully retrieved list of public Objects.

- ObjectListView — A paginated list of Objects.
  - `objects` ObjectView[], required — List of Object entities.
    - `id` string, required — The unique identifier of the Object.
    - `name` string, required — The name of the Object.
    - `state` 'UPLOADING' | 'READ_ONLY' | 'DELETED' | 'ERROR', required
    - `size_bytes` integer, nullable — The size of the Object content in bytes (null until uploaded).
    - `content_type` 'unspecified' | 'text' | 'binary' | 'gzip' | 'tar' | 'tgz', required
    - `create_time_ms` integer, required — The creation time of the Object in milliseconds since epoch.
    - `delete_after_time_ms` integer, nullable — The time after which the Object will be deleted in milliseconds since epoch.
    - `metadata` object, nullable — User defined metadata to attach to the Object for organization.
    - `upload_url` string, nullable — Presigned URL for uploading content to S3 (only present on create).
  - `has_more` boolean, required — True if there are more results available beyond this page.
  - `total_count` integer, nullable — Total number of Objects across all pages.

## Other responses

- `401` — Unauthorized. Invalid or missing authentication.
- `403` — Forbidden. Account does not have devbox capability.
- `500` — Internal server error.

## Changes

- **2026-05-13** `cd3a17e212ec` — 1 info
  - added the optional property `objects/items/metadata` to the response with the `200` status
- **2026-03-24** `32e4b2dfb757` — 1 warning, 1 info
  - removed the optional property `remaining_count` from the response with the `200` status
  - added the new optional `query` request parameter `include_total_count`
- **2026-02-19** `8704a652545c` — 4 breaking
  - the response property `remaining_count` became nullable for the status `200`
  - the response property `total_count` became nullable for the status `200`
  - the response property `remaining_count` became optional for the status `200`
  - the response property `total_count` became optional for the status `200`
- **2025-11-19** `5f33221208c1` — 2 breaking, 4 warning, 11 info
  - the `query` request parameter `content_type` was restricted to a list of enum values
  - the `query` request parameter `state` was restricted to a list of enum values
  - added the new `DELETED` enum value to the `objects/items/state` response property for the response status `200`
  - added the new `ERROR` enum value to the `objects/items/state` response property for the response status `200`
  - …13 more
- **2025-10-15** `436b4f5c7426` — 1 info
  - added the required property `objects/items/create_time_ms` to the response with the `200` status

[Change history](https://skmtc.dev/runloopai/apis/runloop-api/changes/v1/objects/list_public/get.md)

---

[API](https://skmtc.dev/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.dev/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runloopai/runloop-api/revisions/e9dc776053e4/schema)