/vault/secretsList Secrets
Returns a page of the secrets the caller owns or that are shared with them, in path order, without their values. prefix narrows the list to one branch of paths.
Follow nextCursor until it is null to read every page.
| projectId * | query | The project's id. |
| prefix | query | Return only secrets whose path starts with this prefix, such as |
| cursor | query | The previous page's Omit it for the first page. |
| limit | query | The most secrets to return on one page, from 1 to 200. The default is 50. |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | A page of secrets. | |
| 400 | `prefix` isn't a valid path prefix, or `cursor` isn't a cursor this list returned. | |
| 401 | The request carries no authenticated caller. | |
| 500 | An internal error. Retry later. |
| nextCursor | string | null | Cursor for the next page; Example: "eyJuYW1lIjoiZGF0YWJhc2UvcHJvZC9wYXNzd29yZCJ9" |
| secrets * | object[] | The page's secrets: the caller's own and the ones shared with them. |
| createdAt * | string <date-time> | Creation timestamp. Example: "2026-11-01T08:00:00.000Z" |
| createdBy * | string | Creating principal. Example: "usr_7Hq2LmN9pR4s" |
| id * | string |
Example: "sec_4fK9xQ2mZ7aB" |
| kid * | string | KEK reference. Example: "vkey_7Rt2Wq9LxP4m" |
| metadata * | object | Per-secret tags. |
| name * | string | The secret's path. Example: "database/prod/password" |
| ownerId * | string | The secret's owner. It never changes. Example: "usr_7Hq2LmN9pR4s" |
| retiredAt | string <date-time> | null | Retirement timestamp (or Example: "2026-11-15T09:30:00.123Z" |
| rotatedAt | string <date-time> | null | Last rotation timestamp (or Example: "2026-11-15T09:30:00.123Z" |
| updatedAt * | string <date-time> | Last-update timestamp. Example: "2026-11-15T09:30:00.123Z" |
| updatedBy * | string | Last-update principal. Example: "usr_7Hq2LmN9pR4s" |
| version * | integer <int64> | Monotone version. Example: 3 |
| visibility * | any | Who else can list and reveal a secret: |
| One of: object | ||
| kind * | "private" | |
| or: object | ||
| kind * | "shared" | |
| principals | string[] | Subject ids granted read access ( |
| roles | string[] | Roles granted read access (e.g. |
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.kibo.vault.secrets.list()Showing example in TypeScript
{
"nextCursor": "eyJuYW1lIjoiZGF0YWJhc2UvcHJvZC9wYXNzd29yZCJ9",
"secrets": [
{
"createdAt": "2026-11-01T08:00:00.000Z",
"createdBy": "usr_7Hq2LmN9pR4s",
"id": "sec_4fK9xQ2mZ7aB",
"kid": "vkey_7Rt2Wq9LxP4m",
"metadata": {
"team": "payments"
},
"name": "database/prod/password",
"ownerId": "usr_7Hq2LmN9pR4s",
"retiredAt": "2026-11-15T09:30:00.123Z",
"rotatedAt": "2026-11-15T09:30:00.123Z",
"updatedAt": "2026-11-15T09:30:00.123Z",
"updatedBy": "usr_7Hq2LmN9pR4s",
"version": 3,
"visibility": {
"kind": "private"
}
}
]
}