# Trash

Deleted projects, dataset versions, and workflows are moved to your workspace Trash for 30 days before they are permanently removed. You can restore an item from Trash at any time within the 30-day retention window, or permanently delete it immediately if you are certain you do not need it.

## Open the Trash

Navigate to Settings in your workspace and select Trash from the sub-navigation. The page lists every deleted project, version, and workflow grouped by type, along with who deleted each item, when it was deleted, and how many days remain before permanent cleanup.

## Restore an item

Click Restore on a single row to restore that item, or use the checkboxes to select multiple items and click Restore to restore them all at once. Restore All restores every item in the workspace Trash.

Restored items immediately reappear in the workspace in the same location they were deleted from. Dataset versions can only be restored while their parent project is still active. If the parent project is also in Trash, restore the project first and then restore its versions.

## Delete an item permanently

To skip the 30-day retention window and remove an item right away, click Delete Permanently on a single row, or select multiple items and click Delete Permanently. Empty Trash removes everything in the workspace Trash at once. Permanent deletion cannot be undone.

Permanent deletion is available only from this page in the web app. It is not exposed on the REST API, Python SDK, or CLI so that a stray script or automation cannot irrecoverably destroy data.

## What happens when you delete

When a project, version, or workflow is deleted:

* The item is hidden from the workspace and from all API listings.
* Any in-flight training jobs for the item are cancelled automatically so you do not keep spending credits on something you are deleting.
* For projects, the version's trained models stop serving.
* Storage for the item still counts toward your workspace plan until the 30-day retention window expires or you permanently delete it.

If you checked "Also delete images from Asset Library" when deleting a project, an amber indicator on the Trash row shows that images belonging only to that project will also be removed when the project is permanently cleaned up. Images shared with other projects are always preserved.

## Who can use the Trash

Access to the Trash and its actions is controlled by role-based access control. The default Owner role grants all trash permissions. You can assign individual trash permissions (`view_trash`, `trash_dataset`, `restore_dataset`, `trash_version`, `restore_version`, `trash_workflow`, `restore_workflow`) to custom roles from your workspace's Role-Based Access Control settings.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/workspaces/trash.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
