Returns all accessible vaults, optionally filtered by project.
GET /api/v1/machine/vault| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | Yes | Your API key |
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | No | Filter vaults by project ID |
Success (200 OK)
{
"vaults": [
{
"id": "507f1f77bcf86cd799439011",
"name": "Production Secrets",
"isEncrypted": true,
"encryptionKeyId": "507f1f77bcf86cd799439015",
"dataClassification": "CONFIDENTIAL",
"itemCount": 12,
"createdAt": "2026-01-15T10:30:00.000Z"
},
{
"id": "507f1f77bcf86cd799439012",
"name": "Development Config",
"isEncrypted": true,
"encryptionKeyId": "507f1f77bcf86cd799439015",
"dataClassification": "INTERNAL",
"itemCount": 5,
"createdAt": "2026-02-01T08:00:00.000Z"
}
]
}| Field | Type | Description |
|---|---|---|
vaults | array | Array of vault summary objects |
vaults[].id | string | Vault ID |
vaults[].name | string | Vault name |
vaults[].isEncrypted | boolean | null | Whether the vault uses client-side encryption |
vaults[].encryptionKeyId | string | null | Encryption key ID (null if not encrypted) |
vaults[].dataClassification | string | null | Data classification: PUBLIC, INTERNAL, CONFIDENTIAL, or CUI |
vaults[].itemCount | number | Number of non-archived items in the vault |
vaults[].createdAt | string | ISO 8601 creation timestamp |
401 Unauthorized - Invalid or missing API key
{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key. Please provide your API key in the X-API-Key header."
}
}List all vaults:
curl -X GET "https://r4.dev/api/v1/machine/vault" \
-H "X-API-Key: rk_abc123def456.ghijklmnopqrstuvwxyz"Filter by project:
curl -X GET "https://r4.dev/api/v1/machine/vault?projectId=507f1f77bcf86cd799439014" \
-H "X-API-Key: rk_abc123def456.ghijklmnopqrstuvwxyz"projectId, only vaults with project-level permissions are returned