Manage Trash

Projects, dataset versions, and workflows can all be moved to the workspace Trash, where they are retained for 30 days before being permanently cleaned up. Within the retention window you can restore them back to the workspace.

Any in-flight training jobs associated with a project or version are cancelled automatically when it is moved to Trash, so you don't continue spending credits on an item you're deleting.

Delete a Project

Move a project to Trash:

roboflow project delete <workspace>/<project>

Example:

roboflow project delete my-workspace/my-detector

The command prompts for confirmation before moving the project. Pass --yes (or -y) to skip the prompt for scripted use:

roboflow project delete my-workspace/my-detector --yes

Restore a Project

roboflow project restore <workspace>/<project>

Example:

roboflow project restore my-workspace/my-detector

The CLI looks the project up in the workspace Trash by its slug and restores it. If the project isn't currently in Trash, the command exits with an error.

Delete a Version

Move a single dataset version to Trash. Any in-flight training on the version is cancelled.

Example:

Pass --yes to skip confirmation.

Restore a Version

Example:

The parent project must still be active (not itself in Trash) — restore the project first if necessary.

Delete a Workflow

Move a workflow to Trash:

Example:

Pass --yes (or -y) to skip the confirmation prompt. You can pass either the workflow URL slug or its Firestore id.

Restore a Workflow

Example:

List Items in Trash

List everything currently in the workspace Trash:

For structured output suitable for scripting:

Permanent Deletion

Permanent deletion is intentionally not available from the CLI or SDK — emptying Trash and immediately deleting a single Trash item destroy data irrecoverably, and we don't want a stray script or typo to be able to trigger them. These actions are available only through the Trash view in the Roboflow web app, which has an explicit confirmation dialog.

Items left in Trash are cleaned up automatically after the 30-day retention window, so you rarely need to act on them manually.

Last updated

Was this helpful?