Skip to main content
GET
/
v2
/
secrets
/
{path}
List Secrets
curl --request GET \
  --url https://api.tusky.io/v2/secrets/{path}
{
  "path": "<string>",
  "keys": [
    {}
  ]
}
List secret keys at the specified path. Returns key names only — not secret values. Folders (paths with children) are suffixed with /.

​
Path Parameters

​
path
string
The path prefix to list. Use an empty path to list root-level secrets.

​
Query Parameters

​
list
boolean
required
Must be true to trigger list mode instead of read mode.

​
Response

​
path
string
The listed path prefix.
​
keys
array
Array of key names at this path. Entries ending in / are folders containing nested secrets.

​
Example

curl "https://api.tusky.io/v2/secrets/production?list=true" \
  -H "Api-Key: YOUR_API_KEY"

​
Response

{
  "path": "production",
  "keys": [
    "database",
    "redis",
    "api-keys/",
    "certificates/"
  ]
}
Entries like api-keys/ and certificates/ are folders. List them to see their nested keys: GET /secrets/production/api-keys?list=true.