Delete a file | Omni Docs

Delete encrypted file data and stop it from participating in future Vault recall.

curl -sS -X DELETE "$OMNI_API_ORIGIN/v1/files/$OMNI_FILE_ID" \
  -H "Authorization: Bearer $OMNI_API_KEY" \
  -H "Idempotency-Key: delete-$OMNI_FILE_ID"

Deletion requires files:delete. Repeating the same logical deletion with the same idempotency key is safe.

After deletion, the workspace Vault lookup returns a safe 404 not_found, and the file is excluded from future retrieval. Historic assistant messages may retain their citation record as part of durable conversation history, but the deleted source is no longer retrievable.

Destructive action

File deletion is destructive. Verify the public file_id and workspace before sending the request.