Sign in
bus

List objects

Lists objects with the specified prefix.

get/bus/objects/{prefix}

Path parameters

prefixstring required
Example:folder/

The prefix to filter objects by

Query parameters

bucketstring required

The name of the bucket.

Example:default
delimiterstring

Path delimiter ("/" or empty)

limitinteger

Maximum number of objects to return

markerstring

Key to start listing from

sortbystring

Field to sort results by

sortdirstring

Sort direction (asc/desc)

substringstring

Filter objects by substring

slabencryptionkeystring

Encryption key for slabs

Response

Successfully listed objects

hasMoreboolean

Whether there are more objects to fetch

Example response

{
  "objects": [
    {
      "bucket": "default",
      "etag": "W/\"33a64df551425fcc55e4d42a148795d9f25f89d4\""
    }
  ]
}

Changes

Changed in 4 of the 50 revisions of this API.33

  • c38282599c5a11See the full diff
    • ▲

      the objects/items/allOf[subschema #3]/slabs/items/slab/minShards response's property type/format changed from integer/uint8 to / for status 200

      response-property-type-changed

    • ○

      added RedundancySettingsMinShards subschema #2 to the objects/items/allOf[subschema #3]/slabs/items/slab/minShards response property allOf list for the response status 200

      response-property-all-of-added

  • 922f156353c911See the full diff
    • ▲

      removed the media type text/plain for the response with the status 500

      response-media-type-removed

    • ○

      api tag bus added

      api-tag-added

  • d5dec74bd45a1See the full diff
    • ○

      endpoint added

      endpoint-added

  • f062c35d8f471See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 99 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog