Delete a Run

Permanently remove completed, failed, or killed training runs to keep your project organized.

Delete completed, failed, or killed training runs to keep your training project organized and focused on current work. Deletion permanently removes runs along with all training metrics, logs, and trained models.

❗️

This action cannot be undone

  • Permanent deletion — All metrics, logs, and trained models are removed immediately
  • Cannot be recovered — There is no way to restore a deleted training run
  • Models lost — Trained models must be downloaded before deletion
  • History removed — Training progress and experiment data permanently deleted

Before you delete

Review these considerations before permanently deleting a training run:

Download trained models

If the run completed successfully, export the trained model before deletion:

  • Download the trained model — Save model files for deployment or archival
  • Export model configurations — Document workflow settings and training parameters
  • Save evaluation metrics — Capture performance data via screenshots or notes
  • Store in version control — Keep models in local storage or model registry
💡

Models are permanently deleted

Unlike datasets which can be recreated, trained models from deleted runs cannot be recovered. Always download successful models before run deletion.

Document experiment results

Preserve useful information from the training run:

  • Screenshot metrics — Capture loss charts and evaluation scores
  • Note final performance — Record final accuracy, F1, or other key metrics
  • Document what worked — Save configuration details for successful runs
  • Record lessons learned — Note issues encountered for future reference

Verify run is no longer needed

Confirm the run can be safely deleted:

  • Superseded by better runs — Newer training produced superior models
  • Test or experimental run — Used only for workflow validation
  • Failed configuration — Errors fixed and successful run completed
  • Old iterations — Part of project history no longer relevant

Cannot delete runs in progress

The platform prevents deletion of training runs that are actively executing or queued. You must kill active runs before deletion.

Why this safeguard exists

  • Prevents data corruption — Ensures training completes or stops cleanly
  • Avoids resource waste — Forces intentional decision to stop training
  • Maintains data integrity — Training logs and metrics saved properly

How to proceed with active runs

If you try to delete an active run (status: Running, Queued, or Starting):

  1. Kill the run first to stop training

  2. Wait for status to change to "Killed"

  3. Delete the run using the steps below

⏱️

Two-step process for active runs

  1. Kill stops training and saves current state
  2. Delete permanently removes the stopped run

This ensures you intentionally stop training before permanent deletion.


Delete a completed run

Remove finished training runs from your project:

Access delete option

  1. Navigate to the Training section from the sidebar

  2. Click on your training project to open it

  3. Click the Runs tab to view all training runs

  4. Locate the run you want to delete (status must be: Completed, Failed, or Killed)

  5. Click the three-dot menu (⋮) next to the run

  6. Select Delete Run from the dropdown menu

🚫

Active runs show disabled delete option

For runs with status "Running", "Queued", or "Starting", the Delete Run option will be disabled with a tooltip explaining that you must kill the run first.

Confirm deletion

A confirmation dialog appears warning: "This action will permanently delete [Run Name] from your training project. Are you sure you want to delete this training?"

  1. Review the warning carefully—deleted runs cannot be recovered

  2. Click the red Confirm button to permanently delete the run

  3. The run is removed immediately from your runs list

Run deleted successfully

Your training run has been permanently removed from the project. The run no longer appears in:

  • Runs list and navigation
  • Workflow run history
  • Project metrics and dashboards
  • API responses for run queries

What gets deleted

When you delete a training run, the following are permanently removed:

Deleted immediately

  • Trained model — Model artifacts and checkpoints (if run completed successfully)
  • Training metrics — Loss charts, evaluation scores, and performance data
  • Training logs — Complete log output and debugging information
  • Run history — Progress tracking and status updates
  • Resource usage data — GPU time and credit consumption details
  • Configuration snapshot — Training settings captured at run start

Not affected

  • Source workflowWorkflow configuration remains intact and usable
  • Other runs — All other training runs in project completely unaffected
  • Source datasetDataset used for training remains unchanged
  • Compute Credit history — Past credit consumption remains in usage records
  • Project structure — Training project and other workflows unaffected
💡

Cannot recover training history

Once deleted, all training data from this run is permanently lost:

  • Training curves and loss graphs
  • Validation metrics and evaluation results
  • Model checkpoints and final weights
  • Detailed logs and debugging information
  • Experiment notes and observations

There is no backup, trash bin, or recovery mechanism.


Which runs should you delete?

Choose runs to delete based on their value and purpose:

Delete these runs

Failed experiments:

  • Runs that failed due to configuration errors (after fixing issues)
  • Out of memory failures (after reducing model/batch size)
  • Dataset loading errors (after correcting dataset issues)

Test and validation runs:

  • Quick tests to verify workflow configurations work
  • Experimental runs to validate dataset quality
  • Short runs used to test parameter combinations

Superseded runs:

  • Earlier runs replaced by better-performing models
  • Old iterations after successful retraining
  • Baseline runs after optimization complete

Duplicate or accidental runs:

  • Wrong workflow started by mistake
  • Duplicate runs created accidentally
  • Runs started with incorrect settings

Keep these runs

Successful production models:

  • Runs that produced models deployed to production
  • Best-performing runs for your task
  • Baseline runs used for comparison

Reference experiments:

  • Runs demonstrating successful configurations
  • Training with unusual or interesting results
  • Runs referenced in team documentation or papers

Recent active work:

  • Runs from ongoing experiments
  • Training completed within last few weeks
  • Runs pending evaluation or comparison
📁

Archive strategy

Consider this workflow for managing run history:

  1. Download models from all successful runs immediately after completion
  2. Keep recent runs (last 2-4 weeks) for reference and comparison
  3. Delete old test runs and failed experiments monthly
  4. Preserve milestone runs that produced significant improvements
  5. Document reasons for keeping long-term runs

This balances clean project organization with historical reference value.


Best practices for run cleanup

Regular cleanup schedule

Maintain organized training projects with periodic cleanup:

Weekly review:

  • Delete obvious test runs and accidental starts
  • Remove failed runs after fixing issues and retraining
  • Clean up superseded runs from iteration cycles

Monthly audit:

  • Review all completed runs older than 30 days
  • Delete experimental runs no longer needed
  • Archive critical runs by downloading models
  • Update project documentation with important findings

After major milestones:

  • Clean up all runs after successful model deployment
  • Remove iterative experiments that led to final model
  • Keep only final successful run and key baselines

Benefits:

  • Easier to find important runs quickly
  • Clearer project history and progress tracking
  • Reduced cognitive load when reviewing experiments
Download before delete

Always export important artifacts before deletion:

Checklist:

  1. Trained models:

    • Download model files for deployment
    • Save with descriptive names indicating configuration
    • Store in version control or model registry
  2. Metrics and results:

    • Screenshot final evaluation metrics
    • Export loss charts and training curves (if available)
    • Record final accuracy, F1, or other key scores
  3. Configuration details:

  4. Lessons learned:

    • Note what worked well or poorly
    • Document issues encountered and solutions
    • Record insights for future training

Prevention: Create systematic export workflow before any deletion to avoid losing valuable data.

Descriptive naming for clarity

Use clear workflow names to make deletion decisions easier:

Good examples:

  • PCB-Detection-Baseline-v1 — Clear purpose and version
  • Defect-VQA-Test-SmallDataset — Indicates experimental nature
  • Quality-Inspection-Production-Final — Shows production status

Poor examples:

  • New Workflow — Unclear purpose
  • Test — Doesn't indicate what was tested
  • Run 1 — No context about configuration

Benefits:

  • Easy to identify runs safe to delete
  • Understand run purpose without opening details
  • Team members can make informed cleanup decisions
Batch deletion workflow

When deleting multiple runs, use systematic approach:

Preparation:

  1. List all runs in project
  2. Categorize: Keep, Archive (download), Delete
  3. Download models from "Archive" category
  4. Verify downloads successful

Execution:

  1. Start with oldest runs first
  2. Delete from least to most critical (in case interrupted)
  3. Keep running tally of deleted vs. kept runs
  4. Verify deletions complete before moving to next

Documentation:

  1. Note why specific runs were deleted
  2. Record what models were archived
  3. Update project documentation reflecting current state

Efficiency tips:

  • Group similar runs for batch review
  • Use status filters to find failed runs quickly
  • Sort by date to identify old runs easily
Team coordination

For shared training projects, coordinate deletion with team:

Before deleting shared runs:

  1. Announce planned cleanup via team chat or meeting
  2. Share list of runs you plan to delete
  3. Allow review period for team to flag important runs
  4. Confirm no objections before proceeding

Communication channels:

  • Team messaging platforms (Slack, Teams, etc.)
  • Project management tools
  • Shared documentation or wikis
  • Weekly team sync meetings

Prevention:

  • Establish team policy on when runs can be deleted
  • Define ownership for different workflows
  • Use naming conventions to indicate run importance
  • Document cleanup responsibilities

Common questions

Can I recover a deleted training run?

No. Training run deletion is permanent and irreversible.

There is no:

  • Undo functionality
  • Trash bin or recycle bin
  • Backup or restore mechanism
  • Recovery period or grace window
  • Support recovery process

Once deleted, permanently lost:

  • Trained model weights and checkpoints
  • Training metrics and loss curves
  • Detailed logs and debugging information
  • Run configuration and metadata
  • Progress history and timestamps

Best practice: Always download models and export important metrics before deletion. Take screenshots of key information you might need later.

Prevention:

  • Double-check run identity before confirming deletion
  • Download models immediately after successful training
  • Maintain local archives of important models
  • Use caution when performing bulk cleanup
What happens to models from deleted runs?

Models are permanently deleted along with the run. They cannot be recovered.

If model not downloaded:

  • Model is permanently lost
  • Cannot be recovered by support
  • Must retrain to recreate model

If model was downloaded before deletion:

  • Downloaded model files remain on your computer
  • Can still deploy or use the model
  • Model operates independently of Datature platform

Deployment implications:

External deployments (recommended):

  • Models downloaded and deployed externally continue working
  • Run deletion doesn't affect already-deployed models
  • Model operates independently as standalone file

Platform-linked deployments:

  • Direct references to run models may break
  • Best practice: deploy using downloaded model files
  • Update deployments to use exported models

Prevention: Always download models immediately after successful training, before any deletion.

Will deletion free up my Compute Credits?

No. Deleting training runs does not refund Compute Credits.

What happens:

  • Credits consumed by completed training remain spent
  • Past run costs stay in usage history
  • Deletion doesn't affect current credit balance
  • Future training consumes credits normally

Credits are consumed when:

  • Training runs execute on GPU hardware
  • Regardless of whether runs are later deleted
  • Based on actual GPU time used during training

Credit management:

Run deletion purpose:

  • Organize project and clean up history
  • Remove clutter from runs list
  • Free up visual space in UI
  • Not for recovering consumed credits
Can I delete multiple runs at once?

Currently, training runs must be deleted one at a time through the web interface. There is no bulk delete functionality.

To delete multiple runs:

  1. Navigate to the Runs tab
  2. For each run you want to delete:
    • Click the three-dot menu (⋮)
    • Select Delete Run
    • Confirm the deletion
  3. Repeat for each run

Workflow optimization:

Batch deletion session:

  1. Prepare list of runs to delete
  2. Download models from runs needing preservation
  3. Block time for systematic deletion
  4. Work through list one by one
  5. Document progress to track completion

Efficiency tips:

  • Use run filters to show only failed runs or specific statuses
  • Sort by date to find oldest runs easily
  • Start with least critical runs first
  • Take breaks during large cleanup sessions

Feature request: If bulk deletion would help your workflow, consider submitting feedback to the Datature team.

Will my team be notified when I delete a run?

No automatic notification is sent to team members. For shared projects:

Before deletion:

  1. Inform your team about planned deletions
  2. Share list of runs you intend to remove
  3. Allow review period for team to flag important runs
  4. Confirm no blockers from team members

Communication methods:

  • Team chat or collaboration tools
  • Project management systems
  • Email to team members
  • Team standup or sync meetings

Best practice for shared projects:

Establish deletion policy:

  • Who can delete runs (all members, leads only, etc.)
  • Required notice period before deletion
  • Documentation requirements
  • Approval process for production run deletion

Maintain transparency:

  • Post cleanup schedules in team channels
  • Share reasons for deletions
  • Update shared documentation
  • Keep team informed of project state changes
What if I only want to remove failed runs?

You can filter runs by status to focus on failed runs:

Access failed runs:

  1. Navigate to the Runs tab in your training project
  2. Use status filters (if available) to show only "Failed" runs
  3. Review the list of failed runs
  4. Delete individual failed runs as needed

Systematic cleanup:

Weekly failed run review:

  1. Check logs to understand failure reasons
  2. Document fixes applied to prevent recurrence
  3. Delete runs after issues resolved and successful retraining completed
  4. Keep one example of each failure type for reference

When to keep failed runs:

  • Reference examples — Demonstrate specific failure patterns
  • Under investigation — Still debugging root cause
  • Recent failures — Within last few days, haven't retrained yet
  • Team review pending — Waiting for team analysis

When to delete failed runs:

  • Issue resolved — Problem fixed and successful run completed
  • Old failures — From weeks/months ago, no longer relevant
  • Obvious mistakes — Clear configuration errors, not informative
  • Duplicates — Multiple runs with same failure
Can I export run data before deletion?

Currently, there is no "export all run data" feature. You must manually save components:

What you can export:

1. Trained models:

  • Download model files for completed runs
  • Save with descriptive filenames
  • Store in organized directory structure

2. Metrics (manual export):

  • Screenshot loss charts and evaluation metrics
  • Copy final metric values to spreadsheet or notes
  • Export chart images if platform allows
  • Record in experiment tracking system

3. Configuration (manual documentation):

  • Document workflow settings used
  • Screenshot or copy system prompt text
  • Note dataset splits and parameters
  • Record model architecture details

4. Logs (view and copy):

  • View detailed logs in platform
  • Copy relevant log sections to text files
  • Screenshot error messages or important output
  • Save debugging information locally

Recommended workflow:

Create run archive folder:

project-name/
├── models/
│   ├── run-001-baseline-model.pth
│   └── run-015-optimized-model.pth
├── metrics/
│   ├── run-001-results.png
│   └── run-015-results.csv
├── configs/
│   ├── run-001-config.txt
│   └── run-015-config.txt
└── logs/
    ├── run-001-errors.log
    └── run-015-training.log

Best practice: Establish export workflow early in project to maintain consistent archives before deletion.

I accidentally deleted the wrong run. What can I do?

Unfortunately, deletion is permanent and irreversible.

No recovery options:

  • Cannot restore through support
  • No server-side backups available
  • No undo or rollback functionality
  • No trash bin or recycle bin

Your only options:

1. Use local backups (if you have them):

  • Reinstall downloaded model if you saved it
  • Reference exported metrics and screenshots
  • Review saved logs and configurations

2. Retrain from scratch (if no backups exist):

3. Accept the loss (if critical data lost):

  • Training history permanently gone
  • Model must be retrained if not backed up
  • Metrics cannot be recovered
  • Learn from experience for future prevention

Prevention measures:

Immediate actions:

  • Download all successful models right after training completes
  • Export key metrics before any deletion
  • Verify run identity before confirming deletion
  • Double-check run name in confirmation dialog

Long-term practices:

  • Establish automatic model download workflow
  • Use descriptive naming to avoid confusion
  • Implement team approval for production run deletion
  • Maintain systematic archive of important experiments
  • Document deletion decisions and reasoning

Before clicking Confirm:

  • Read confirmation message carefully
  • Verify run name matches intended deletion
  • Check run start time to confirm identity
  • Ensure any needed data already exported

Deletion workflow

Follow this recommended workflow for safe run deletion:

1. Identify deletion candidates

Review training runs and categorize:

  • Active development — Keep for ongoing work
  • Production models — Download models, then delete or keep
  • Successful experiments — Download models, then delete
  • Failed runs — Review, then delete after fixing issues
  • Test runs — Delete after serving purpose

2. Prepare for deletion

For each run to delete:

  1. Download trained models if run completed successfully
  2. Screenshot metrics — Capture key performance data
  3. Export configurations — Document workflow settings
  4. Check dependencies — Verify no external references

3. Coordinate with team

For shared projects:

  1. Notify team — Announce planned deletions
  2. Allow review — Give team time to flag important runs
  3. Confirm approval — Ensure no blockers
  4. Update documentation — Remove run references

4. Delete the runs

  1. Navigate to the Runs tab
  2. Select Delete Run from menu
  3. Read warning carefully
  4. Click Confirm
  5. Verify removal from list

5. Verify and document

After deletion:

  1. Confirm removal — Verify runs no longer appear
  2. Update records — Note what was deleted and why
  3. Verify exports — Ensure model files safely stored
  4. Document decision — Record deletion rationale

Next steps


Related resources