GET
/v1/apps/secretsList secrets
Lists secrets stored in the specified Secret Store scope. Supply scope to select account-level or user-level secrets, and use cursor parameters to retrieve additional pages of results.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
ending_beforestringoptional
An object ID cursor that identifies the position before the page to retrieve.
expandarray<string>optional
Specifies response fields to expand; each value can be up to 5000 characters.
limitintegeroptional
The number of secrets to return, from 1 to 100. Defaults to 10 when omitted.
scopeobjectrequired
The secret scope object. Its `type` must be `account` or `user`; user-scoped requests can include the user identifier in `user`.
starting_afterstringoptional
An object ID cursor that identifies the position after the page to retrieve.
200Returns a list of secret objects with scope information and pagination metadata, including `data`, `has_more`, `object`, and `url`.
dataarray<Secret>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired
Error handling
scope is required and its type must be either account or user; include scope.user when identifying a user-scoped secret. limit must be between 1 and 100 and defaults to 10 when omitted, while cursor values identify positions in the list.