Browse docs+

Archive Vault Item

Archives (soft-deletes) a vault item. The item no longer appears in active listings, but it is retained for audit purposes.

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

Important

This write path no longer requires a replacement summary checkpoint in the request body.
The operation archives the item only; it does not permanently delete stored audit history.
The archive is audit-logged and touches the parent vault-item timestamp for sync clients.

Headers

Header	Type	Required	Description
`X-API-Key`	string	Yes	Your machine API key

Path Parameters

Parameter	Type	Required	Description
`vaultId`	string	Yes	The unique identifier of the vault
`itemId`	string	Yes	The unique identifier of the vault item to archive

Request Body

No request body is required.

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 in vault \"507f1f77bcf86cd799439011\" 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 endpoint requires machine.vault.write and access to the target vault item.
Use List Vault Items after archiving to read the refreshed active item list.