Search Documentation
Search across all documentation pages
delete_media
Delete a media attachment and its embedding. Permanently removes the file from encrypted storage and deletes the associated multimodal embedding vector.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| attachmentId | string (UUID) | required | The attachment ID to delete |
| vaultId | string (UUID) | optional | Vault scope (defaults to defaultVaultId) |
Returns#
Confirmation of deletion.
Example#
json
{
"tool": "delete_media",
"arguments": {
"attachmentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}Notes#
- Requires gateway mode (agent key). Not available in direct Supabase mode.
- This action is irreversible — the file, embedding, and extracted text are permanently removed.
- Storage quota is freed after deletion.