Vaults

List all vaults for the authenticated organization. Returns vault metadata including name, description, storage configuration, and usage statistics. Pagination is opt-in: pass limit (1-200) to receive a bounded page, then replay pagination.next_cursor as ?cursor= while pagination.has_more is true. A request with neither limit nor cursor still returns every vault, and pagination.limit is null. That default will become a bounded page in a future release — paginate now to avoid the change.

get/vault

Request

  • Base URL
    https://api.case.dev
  • URL
    https://api.case.dev/vault
  • Auth
    HTTP bearer

Query parameters

limitinteger

Vaults per page (1-200). Omit to receive every vault. Supplying a cursor without a limit uses 50.

cursorstring

Opaque continuation cursor from pagination.next_cursor of the previous page. Must be replayed with the same API key scope and query that produced it.

querystring

Case-insensitive substring match on the vault name.

include_totalsboolean

When true, adds totals covering every vault matching the filters, not just this page. Scans all objects in those vaults, so request it once per filter change rather than on every page.

Response

Vaults retrieved successfully

totalinteger

Number of vaults in this response

Changes

    • warning

      removed the optional property // from the response with the status

    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter include_totals

    • info

      added the new optional query request parameter limit

    • info

      added the new optional query request parameter query

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status