List objects in a cloud storage container

List files and folders within a specific cloud storage container. Returns an object 'key' (name/path) that you can use to retrieve or manage specific objects with subsequent calls.

Object Storage Objects

Context

Workflow links

Produces

Path Parameters

name string required Example: f13

name parameter

Query Parameters

delimiter string required · Example: /
maxKeys string required · Example: 100

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.folders array<object> required · Example: [{"prefix":"cnpg-cluster/base/20260327T155531/"}]
data.folders[].prefix string · enum required · Example: cnpg-cluster/base/20260327T155531/
cnpg-cluster/
cnpg-cluster/base/
cnpg-cluster/base/20260327T155531/
data.isTruncated boolean required · Example: false
data.keyCount integer required · Example: 1
data.nextContinuationToken string · Example: YOUR_TOKEN
data.objects array<object> · Example: [{"key":"bench-256mb.bin","size":268435456,"lastModified":"2026-02-10T00:00:00.000Z","e...
data.objects[].etag string required · Example: "4054985850c403bee99c10607ab456fb-32"
data.objects[].key string required · Example: bench-256mb.bin
data.objects[].lastModified string required · Example: 2026-02-10T00:00:00.000Z
data.objects[].size integer · Example: 268435456
data.objects[].storageClass string · Example: STANDARD
data.prefix string · enum · Example:
cnpg-cluster/
cnpg-cluster/base/
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/object-storage/buckets/{name}/objects
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/object-storage/buckets/f13/objects?delimiter=%2F&maxKeys=100" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "objects": [
      {
        "key": "bench-256mb.bin",
        "size": 268435456,
        "lastModified": "2026-02-10T00:00:00.000Z",
        "etag": "\"4054985850c403bee99c10607ab456fb-32\"",
        "storageClass": "STANDARD"
      }
    ],
    "folders": [],
    "prefix": "",
    "isTruncated": false,
    "nextContinuationToken": "YOUR_TOKEN",
    "keyCount": 1
  }
}