SPsparkvault
vaults

List a vault's ingots

Changed on

A page of the vault's ingots, in the vault index's order. sort_by orders only the ingots of the page it answers, never the list across pages: for one order across the vault, search (GET /vaults/{id}/ingots/search) or list a folder's contents (GET /vaults/{id}/contents). Page with cursor until has_more is false.

get/vaults/{id}/ingots

Request

Path parameters

idstring required

The vault.

Query parameters

limitinteger

A page-size hint: a value above 200 reads as 200, and a missing, zero, negative or non-numeric one as 100.

cursorstring

The next_cursor a previous page returned. Opaque, and sealed to the query that issued it.

sort_by'name' | 'size' | 'size_bytes' | 'content_type' | 'created' | 'created_at' | 'access_count' | 'bandwidth' | 'total_bandwidth_bytes'

Orders the page's ingots, and only that page's. Omitted: the vault index's order.

sort_order'asc' | 'desc'

Response

A page of ingots.

Changes

  • a9a10e328ba5Revision changes
    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter limit

    • info

      added the new optional query request parameter sort_by

    • info

      added the new optional query request parameter sort_order

    • info

      added the non-success response with the status

    • info

      added the success response with the status