How Data Deletion Works
ABV provides deletion at multiple levels, from individual traces to complete organizations:Select deletion scope
- Single trace: Delete one specific trace (e.g., trace containing PII)
- Batch of traces: Select multiple traces and delete together
- Query-based deletion: Delete all traces matching filters (e.g., all traces for user_id=âjohnâ)
- Project deletion: Remove entire project with all data
- Organization deletion: Remove organization and all associated data
- User account deletion: Remove user account from ABV
Execute deletion
- UI: Visual selection and deletion for traces, projects, and organizations
- API: Programmatic deletion for automation and bulk operations
- Automatic: Scheduled deletion via data retention policies
Deletion processing
Verification and confirmation
Deleting Traces
Trace deletion removes the trace and all related entities: observations (LLM calls, retrieval steps), scores (evaluations, user feedback), and media assets (images, audio).Single Trace Deletion
Via UI
Navigate to traces view
Locate the trace
Open action menu
Action column, click the three dots button for the trace you want to delete.Confirm deletion
Delete and confirm in the dialog. The trace and all related data (observations, scores) will be scheduled for deletion.Via API
Delete a specific trace by ID:traces:delete permission (Owner or Admin roles).
Response: 204 No Content on success.
API Reference â
Batch Trace Deletion
Delete multiple selected traces in a single operation.Via UI
Select traces
Open batch actions
Actions dropdown that appears when traces are selected.Confirm deletion
Delete from the dropdown and confirm. All selected traces and related data will be deleted.Via API
Delete multiple traces in a single API call:Query-Based Deletion
Delete all traces matching specific filtersâuseful for GDPR compliance (delete all traces for a user) or cleanup (delete all test data).Via UI
Configure filters
- User ID equals â[email protected]â
- Tag contains âtest-dataâ
- Date range for development period
Select all matching traces
Delete all selected
Actions > Delete and confirm.Via API
Delete traces matching query filters programmatically:- GDPR compliance: Delete all traces for a specific user
- Test cleanup: Delete all traces with tag âtest-dataâ
- Time-based cleanup: Delete traces older than a certain date (combine with data retention for automation)
Deletion Timing and Limitations
Timeline:- Most traces deleted within 15 minutes of deletion request
- During high deletion volume, processing may take longer
- No confirmation sent when deletion completes
- ABV limits concurrent deletion operations to protect system performance
- Large deletion requests queue and process incrementally
- If you need to delete millions of traces, consider using data retention policies instead
- Query the data again to verify deletion (deleted traces wonât appear in results)
- Check audit logs to confirm deletion request was logged
Deleting Projects
Project deletion removes all data associated with the project: traces, scores, prompts, datasets, evaluations, configurations, and API keys.Navigate to project settings
Scroll to Danger Zone
Delete project
Immediate effects
- All API keys are immediately revoked (applications stop functioning)
- Project scheduled for complete deletion within minutes
- All data irreversibly removed: traces, observations, scores, prompts, datasets, configurations
- All traces and observations
- All scores and evaluation results
- All prompts and prompt versions
- All datasets and dataset items
- All configurations (LLM connections, integrations)
- All API keys (immediately revoked)
- All project-specific settings
- Audit logs (immutable, for compliance)
- Organization-level resources (if the project was part of an organization)
- Project reached end-of-life (POC concluded, feature sunset)
- Customer churned (remove their dedicated project in multi-tenant deployment)
- Security incident (delete compromised project to prevent further access)
Deleting Organizations
Organization deletion removes the organization and all associated data. Projects must be deleted firstâorganizations can only be deleted when empty.Delete all projects
Navigate to organization settings
Scroll to Danger Zone
Delete organization
- Organization record and settings
- Organization memberships (user associations with this organization)
- Organization-scoped API keys
- Billing information associated with the organization
- User accounts (users remain in ABV, just removed from this organization)
- Other organizations the users belong to
- Audit logs of organization activities (for compliance)
Deleting User Accounts
User account deletion removes the user from ABV entirely, including all organization memberships and personal data.- Email address of the account to delete
- Confirmation that you own the account or have authorization to request deletion
- Organization context (if deleting as part of offboarding)
- User account and authentication credentials
- Organization and project memberships
- Personal information (name, email, profile)
- User-created API keys
- Audit logs showing historical activities (for compliance, but user personally identifiable information is anonymized)
- Resources created by the user (prompts, traces, datasets) remain attributed to the organization/project, not the individual user
Compliance Use Cases
GDPR Right to Be Forgotten
Identify user data
userId or search for email addresses/names in trace data.Delete traces via query
- Filter by
userIdmatching the userâs identifier - Select all matching traces
- Confirm deletion
Remove from datasets
Delete user account
Document for compliance
HIPAA Data Deletion
Healthcare applications must delete protected health information (PHI) when legally required.Identify PHI-containing traces
Execute deletion
Verify complete removal
Document destruction
Development Data Cleanup
Remove test and development data that pollutes production analytics.Tag test data during creation
Filter and delete
- Filter traces by tag âtest-dataâ
- Select all matching traces
- Confirm deletion
Automate with retention policies
Common Scenarios
Delete All Data for a User (GDPR)
Delete All Data for a User (GDPR)
- Identify the userâs identifier (email, userId)
- Use query-based deletion to remove all traces: filter by
userId, select all matching, delete - Check datasets for any test cases with user data, delete manually
- Contact support to delete the userâs account
- Export audit logs showing deletions for compliance documentation
Clean Up Test Data
Clean Up Test Data
- Filter traces by tag âtest-dataâ or other identifying marker
- Select all matching traces
- Delete
- Verify deletion by querying again (should return no results)
Remove Accidentally Exposed PII
Remove Accidentally Exposed PII
- Identify affected time range (when did the bug exist?)
- Filter traces by time range and any identifying markers
- Review sample traces to confirm they contain PII
- Execute batch or query-based deletion
- Fix the code to prevent future PII logging
- Document the incident and deletion for compliance/security review
Delete POC Project After Completion
Delete POC Project After Completion
- Export any valuable data (successful prompts, evaluation results, learnings)
- Notify team members that project will be deleted
- Navigate to Project Settings > General > Danger Zone
- Delete project (immediately revokes API keys, removes all data)
Customer Churn in Multi-Tenant Deployment
Customer Churn in Multi-Tenant Deployment
- Verify customer confirmed cancellation and data deletion
- Export customer data if contractually required (for handoff or records)
- Delete customerâs project (removes all their traces, prompts, datasets)
- Update billing system to stop charges
- Document deletion in customer offboarding records