v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Bucket Objects

List Objects (GET)

List objects in a bucket via GET with cursor-based pagination. Use POST /list for filtering and sorting.

get/v1/buckets/{bucket_identifier}/objects

Path parameters

bucket_identifierstring required

The unique identifier of the bucket.

Query parameters

limitinteger nullable

page_sizeinteger nullable

offsetinteger nullable

pageinteger nullable

cursorstring nullable

next_cursorstring nullable

afterstring nullable

include_totalboolean

Response

Successful Response

Example response

{
  "pagination": {
    "has_more": false,
    "limit": 10,
    "skip": 0
  },
  "results": [
    {
      "blobs": [],
      "bucket_id": "bkt_9xy8z7",
      "created_at": "2024-10-21T10:30:00Z",
      "key_prefix": "/contract-2024",
      "metadata": {
        "category": "contracts",
        "year": 2024
      },
      "object_id": "obj_123abc456def",
      "status": "DRAFT",
      "updated_at": "2024-10-21T10:30:00Z"
    }
  ]
}