R4

Archive Vault Item

Archives (soft-deletes) a vault item. The item will no longer appear in listings but is retained for audit purposes.

DELETE /api/v1/machine/vault/:vaultId/items/:itemId

Headers

HeaderTypeRequiredDescription
X-API-KeystringYesYour API key

Path Parameters

ParameterTypeRequiredDescription
vaultIdstringYesThe unique identifier of the vault
itemIdstringYesThe unique identifier of the vault item to archive

Response

Success (204 No Content)

No response body is returned on success.

Error Responses

404 Not Found - Vault item not found or not accessible

{
  "error": {
    "code": "vault_item_not_found",
    "message": "The vault item with ID \"507f1f77bcf86cd799439021\" was not found or you do not have access to it."
  }
}

Example Request

curl -X DELETE "https://r4.dev/api/v1/machine/vault/507f1f77bcf86cd799439011/items/507f1f77bcf86cd799439021" \
  -H "X-API-Key: rk_abc123def456.ghijklmnopqrstuvwxyz"

Notes

  • This is a soft-delete operation. The item is marked as archived but not permanently deleted.
  • Archived items are retained for audit and compliance purposes.
  • This action is audit-logged for CMMC AU-2 / SOC 2 CC7.2 compliance.

Use Cases

  • Secret rotation: Archive old credentials after deploying new ones
  • Cleanup: Remove stale or unused vault items
  • Decommissioning: Archive items when retiring services or environments