/vaultGet Vault Status
Returns the project's custody mode, its active key, and the last custody change that completed.
Needs PROJECT_VIEWER.
| projectId * | query | The project's id. |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | The project's vault status. | |
| 401 | The request carries no authenticated caller. | |
| 404 | No such project, or its keys were destroyed. | |
| 500 | An internal error. Retry later. |
| activeKeyId | string | null | Identifier of the project's currently-active vault key (monotone scalar per F1; Absent until the project is first keyed. Example: "vkey_7Rt2Wq9LxP4m" |
| activeSince | string <date-time> | null | Timestamp the current custody mode became active (i.e., the most recent custody-mode-transition completion timestamp; or project creation time if no transition has occurred). Absent until the project is first keyed. Example: "2026-11-01T08:00:00.000Z" |
| attestation | any | |
| One of: null | ||
| or: object | ||
| lastAttestedAt * | string <date-time> | Last successful re-attestation timestamp. Example: "2026-11-15T09:30:00.123Z" |
| provider * | string | Attestation provider — Example: "sev-snp" |
| byokRef | any | |
| One of: null | ||
| or: object | ||
| externalKeyId * | string | Provider-specific external key identifier (e.g., AWS KMS key ARN; GCP Cloud KMS resource path). Example: "arn:aws:kms:eu-central-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" |
| provider * | string | BYOK provider slug — Example: "aws-kms" |
| region * | string | The project's region pin ( The key's own provider location is inside Example: "de01" |
| custodyMode * | "PLATFORM_MANAGED" | "CONFIDENTIAL_WORKLOAD" | "BYOK" | "HYOK" | Custody mode of a project's vault. |
| hyokRef | any | |
| One of: null | ||
| or: object | ||
| clusterId | string | null | Identifier of the HYOK cluster this project's keys are scoped to (org-level resource). Example: "hyokcluster_0b6f2c1e-3d4a-4b5c-8d9e-0f1a2b3c4d5e" |
| provider * | string | HYOK provider, as stored ( Example: "kmip" |
| lastCompletedJob | any | |
| One of: null | ||
| or: object | ||
| completedAt * | string <date-time> | The database time of the completing transaction. Example: "2026-11-15T09:30:00.123Z" |
| completedSeq | integer <int64> | null | The job's place in the project's completed-job order (null before 0060). Example: 12 |
| jobId * | string |
Example: "ctjob_7c9e6679-7425-40de-944b-e07fc1f90ae7" |
| restoreEpoch | string | null | The A change means sequence values were reissued: reset the watermark. Example: "rfn_3Hk8Pz2Qw7Ln" |
| restoreGeneration | integer <int64> | null | The ordered Example: 2 |
| toMode * | "PLATFORM_MANAGED" | "CONFIDENTIAL_WORKLOAD" | "BYOK" | "HYOK" | Custody mode of a project's vault. |
| lastKeyRotation | string <date-time> | null | Last completed key rotation timestamp. Example: "2026-11-15T09:30:00.123Z" |
| ledgerEventCount * | integer <int64> | Total event count in the project's signed audit ledger. Example: 1842 |
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.vault.status()Showing example in TypeScript
{
"activeKeyId": "vkey_7Rt2Wq9LxP4m",
"activeSince": "2026-11-01T08:00:00.000Z",
"custodyMode": "PLATFORM_MANAGED",
"lastKeyRotation": "2026-11-15T09:30:00.123Z",
"ledgerEventCount": 1842
}