> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/get-started/ko/platform/workspaces/trash.md).

# 휴지통

삭제 후 30일 이내에 삭제된 프로젝트, 데이터셋 버전, 학습, 또는 워크플로를 복원하세요.

## 정보

삭제된 프로젝트, 데이터 세트 버전, 학습 및 워크플로는 30일 동안 워크스페이스 휴지통으로 이동한 후 영구 삭제됩니다. 30일 보존 기간 내에는 언제든지 휴지통에서 항목을 복원할 수 있으며, 필요하지 않다고 확신하는 경우 즉시 영구 삭제할 수도 있습니다.

## 웹 앱

### 휴지통 열기

워크스페이스의 설정으로 이동한 다음 하위 탐색 메뉴에서 휴지통을 선택합니다. 이 페이지에는 삭제된 모든 프로젝트, 버전, 학습 및 워크플로가 유형별로 표시되며, 각 항목을 삭제한 사람, 삭제 시점, 영구 정리까지 남은 일수도 함께 표시됩니다.

### 항목 복원

개별 행에서 복원을 클릭하면 해당 항목이 복원됩니다. 확인란을 사용해 여러 항목을 선택한 다음 복원을 클릭하면 한 번에 모두 복원됩니다. 모두 복원은 워크스페이스 휴지통에 있는 모든 항목을 복원합니다.

복원된 항목은 삭제되었던 위치의 워크스페이스에 즉시 다시 표시됩니다. 데이터 세트 버전은 상위 프로젝트가 아직 활성 상태인 경우에만 복원할 수 있습니다. 상위 프로젝트도 휴지통에 있다면 먼저 프로젝트를 복원한 다음 버전을 복원하세요. 학습도 마찬가지입니다. 먼저 상위 프로젝트와 버전을 복원하세요.

### 항목 영구 삭제

30일 보존 기간을 건너뛰고 항목을 즉시 삭제하려면 개별 행에서 영구 삭제를 클릭하거나 여러 항목을 선택한 다음 영구 삭제를 클릭합니다. 휴지통 비우기를 선택하면 워크스페이스 휴지통의 모든 항목이 한 번에 삭제됩니다. 영구 삭제는 취소할 수 없습니다. 프로젝트를 영구 삭제하면 기본 워크플로도 함께 삭제되며, 해당 프로젝트의 URL을 다시 사용할 수 있습니다.

영구 삭제는 웹 앱의 이 페이지에서만 사용할 수 있습니다. 실수로 실행된 스크립트나 자동화가 데이터를 복구 불가능하게 삭제하지 못하도록 REST API, Python SDK 또는 CLI에서는 제공되지 않습니다.

### 삭제하면 어떻게 되나요?

프로젝트, 버전, 학습 또는 워크플로를 삭제하면 다음과 같은 일이 발생합니다.

* 해당 항목이 워크스페이스와 모든 API 목록에서 숨겨집니다.
* 삭제하려는 항목에 대해 진행 중인 학습 작업은 자동으로 취소되므로, 삭제하는 항목에 크레딧이 계속 사용되지 않습니다.
* 프로젝트의 경우 해당 버전의 학습된 모델 제공이 중지됩니다.
* 학습의 경우 해당 실행으로 생성된 모델도 숨겨지며, 버전의 `{project}/{version}` 모델 ID가 다른 모델로 전환될 수 있습니다.
* 30일 보존 기간이 만료되거나 항목을 영구 삭제할 때까지 해당 항목의 저장 공간은 워크스페이스 요금제의 사용량에 계속 포함됩니다.

프로젝트 삭제 시 "에셋 라이브러리에서도 이미지 삭제"를 선택했다면, 휴지통 행에 황색 표시가 나타나 해당 프로젝트에만 속한 이미지도 프로젝트가 영구 정리될 때 삭제됨을 알려줍니다. 다른 프로젝트와 공유되는 이미지는 항상 보존됩니다.

### 휴지통 사용 권한

휴지통 및 관련 작업에 대한 액세스는 역할 기반 액세스 제어로 관리됩니다. 기본 소유자 역할에는 모든 휴지통 권한이 부여됩니다. 개별 휴지통 권한(`view_trash`, `trash_dataset`, `restore_dataset`, `trash_version`, `restore_version`, `trash_training`, `restore_training`, `delete_training`, `trash_workflow`, `restore_workflow`)을 워크스페이스의 역할 기반 액세스 제어 설정에서 맞춤 역할에 할당할 수 있습니다.

## HTTP API

API를 통해 삭제한 항목도 웹 앱에서와 마찬가지로 휴지통으로 이동합니다. 영구 삭제는 웹 앱에서만 가능하므로 스크립트나 자동화로 데이터를 완전히 삭제할 수 없습니다. 휴지통에 남아 있는 항목은 30일 보존 기간이 지나면 삭제됩니다.

### 프로젝트를 휴지통으로 이동

프로젝트에서 진행 중인 학습은 취소됩니다.

{% openapi src="/files/53635b86ee4859a0a7a8eb0a53b30bc72f5a33c1" path="/{workspace}/{project}" method="delete" %}
[trash.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-313d8db46e74ff4b1b49db56d8288372661ac478%2Ftrash.yaml?alt=media)
{% endopenapi %}

### 버전을 휴지통으로 이동

해당 버전에서 진행 중인 학습은 취소됩니다.

{% openapi src="/files/53635b86ee4859a0a7a8eb0a53b30bc72f5a33c1" path="/{workspace}/{project}/{version}" method="delete" %}
[trash.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-313d8db46e74ff4b1b49db56d8288372661ac478%2Ftrash.yaml?alt=media)
{% endopenapi %}

### 워크플로를 휴지통으로 이동

{% openapi src="/files/53635b86ee4859a0a7a8eb0a53b30bc72f5a33c1" path="/{workspace}/workflows/{workflowId}" method="delete" %}
[trash.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-313d8db46e74ff4b1b49db56d8288372661ac478%2Ftrash.yaml?alt=media)
{% endopenapi %}

### 휴지통 항목 나열

각 항목에는 `type`, `id`및 `parentId` 값이 포함되며, 이 값을 전달해 항목을 복원합니다.

{% openapi src="/files/53635b86ee4859a0a7a8eb0a53b30bc72f5a33c1" path="/{workspace}/trash" method="get" %}
[trash.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-313d8db46e74ff4b1b49db56d8288372661ac478%2Ftrash.yaml?alt=media)
{% endopenapi %}

### 항목 복원

하위 항목보다 상위 항목을 먼저 복원하세요. 버전을 복원하려면 해당 프로젝트를 휴지통에서 꺼내야 하며, 학습을 복원하려면 프로젝트와 버전을 모두 꺼내야 합니다. 항목은 삭제되었던 위치에 다시 표시됩니다.

{% openapi src="/files/53635b86ee4859a0a7a8eb0a53b30bc72f5a33c1" path="/{workspace}/trash/restore" method="post" %}
[trash.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-313d8db46e74ff4b1b49db56d8288372661ac478%2Ftrash.yaml?alt=media)
{% endopenapi %}

## Python SDK

Python SDK를 통해 삭제된 프로젝트와 데이터세트 버전은 워크스페이스 **휴지통** 으로 이동되며, 영구적으로 삭제되기 전에 30일 동안 보관됩니다. 보관 기간 내에 워크스페이스로 복원할 수 있습니다.

프로젝트나 버전이 휴지통으로 이동되면 진행 중인 학습 작업이 자동으로 취소되므로 크레딧이 계속 소모되지 않습니다.

### 프로젝트 삭제

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace().project("my-detector")

project.delete()
```

프로젝트는 워크스페이스 프로젝트 목록에서 즉시 숨겨지고 설정 → 휴지통의 휴지통 화면에 표시됩니다.

### 프로젝트 복원

아직 `Project` 객체에 대한 참조가 있다면 해당 객체에서 `restore()` 를 호출하세요:

```python
project.restore()
```

SDK는 슬러그를 사용하여 워크스페이스 휴지통에서 프로젝트를 찾아 복원합니다. `RuntimeError` 는 프로젝트가 현재 휴지통에 없을 경우 발생합니다.

### 버전 삭제

단일 데이터세트 버전을 휴지통으로 이동합니다. 해당 버전에서 진행 중인 학습은 취소됩니다.

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace().project("my-detector")
version = project.version(3)

version.delete()
```

### 버전 복원

```python
version.restore()
```

버전을 복원하려면 상위 프로젝트가 여전히 활성 상태여야 합니다. 즉, 프로젝트 자체가 휴지통에 없어야 합니다. 필요한 경우 먼저 프로젝트를 복원하세요.

### 휴지통 항목 목록 조회

현재 워크스페이스 휴지통에 있는 항목을 확인하려면 `Workspace.trash()` 를 사용하세요:

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
ws = rf.workspace()

trash = ws.trash()
for item in trash["items"]:
    print(item["type"], item["name"], "cleanup:", item["scheduledCleanupAt"])
```

`trash["sections"]` 에서는 편의를 위해 동일한 항목을 `projects`, `versions` 및 `workflows` 로 그룹화합니다.

### ID로 복원

아직 `Project` 또는 `Version` 핸들이 없다면(예를 들어 이전 세션에서 삭제된 항목을 복원하는 경우) `Workspace.restore_from_trash()` 에 다음에서 반환한 ID를 사용하세요: `trash()`:

```python
trash = ws.trash()
project_in_trash = trash["sections"]["projects"][0]

ws.restore_from_trash("project", project_in_trash["id"])
```

버전의 경우 상위 프로젝트 ID를 전달합니다:

```python
version_in_trash = trash["sections"]["versions"][0]
ws.restore_from_trash(
    "version",
    version_in_trash["id"],
    parent_id=version_in_trash["parentId"],
)
```

### 워크플로

현재 SDK는 `Workflow` 객체를 제공하지 않지만, 저수준 `rfapi` 헬퍼를 통해 워크플로를 소프트 삭제하고 다음을 사용해 복원할 수 있습니다: `Workspace.restore_from_trash("workflow", ...)`:

```python
from roboflow.adapters import rfapi

# 소프트 삭제 - 워크플로를 30일 동안 휴지통으로 이동합니다.
rfapi.delete_workflow(api_key, ws.url, "slow-webhooks")

# 복원 - 먼저 휴지통에서 워크플로의 ID를 조회합니다.
trash = ws.trash()
wf = next(w for w in trash["sections"]["workflows"] if w["url"] == "slow-webhooks")
ws.restore_from_trash("workflow", wf["id"])
```

### 영구 삭제

영구 삭제 기능은 SDK에서 의도적으로 제공하지 않습니다. 휴지통 비우기와 휴지통의 단일 항목을 즉시 삭제하는 작업은 데이터를 복구할 수 없게 파기하며, 예기치 않은 스크립트가 이러한 작업을 실행하지 못하도록 하기 위해서입니다. 이러한 작업은 명시적인 확인 대화상자가 표시되는 Roboflow 웹 앱의 휴지통 보기에서만 사용할 수 있습니다.

휴지통에 남아 있는 항목은 30일 보관 기간이 지나면 자동으로 정리되므로, 일반적으로 직접 처리할 필요가 없습니다.

## CLI

프로젝트, 데이터셋 버전, 워크플로는 모두 워크스페이스의 **휴지통**으로 이동할 수 있으며, 영구 정리되기 전까지 30일 동안 보관됩니다. 보관 기간 내에 워크스페이스로 복원할 수 있습니다.

프로젝트 또는 버전과 연결된 진행 중인 학습 작업은 해당 항목을 휴지통으로 이동할 때 자동으로 취소되므로, 삭제하려는 항목에 크레딧이 계속 사용되지 않습니다.

### 프로젝트 삭제

프로젝트를 휴지통으로 이동:

```bash
roboflow project delete <workspace>/<project>
```

예:

```bash
roboflow project delete my-workspace/my-detector
```

프로젝트를 이동하기 전에 명령어에서 확인을 요청합니다. 스크립트에서 사용할 때는 확인 요청을 건너뛰려면 `--yes` (또는 `-y`)를 전달합니다:

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

### 프로젝트 복원

```bash
roboflow project restore <workspace>/<project>
```

예:

```bash
roboflow project restore my-workspace/my-detector
```

CLI는 슬러그를 기준으로 워크스페이스 휴지통에서 프로젝트를 찾아 복원합니다. 프로젝트가 현재 휴지통에 없으면 명령어가 오류와 함께 종료됩니다.

### 버전 삭제

단일 데이터세트 버전을 휴지통으로 이동합니다. 해당 버전에서 진행 중인 학습은 취소됩니다.

```bash
roboflow version delete <workspace>/<project>/<version>
```

예:

```bash
roboflow version delete my-workspace/my-detector/3
```

확인 요청을 건너뛰려면 `--yes` 를 전달합니다.

### 버전 복원

```bash
roboflow version restore <workspace>/<project>/<version>
```

예:

```bash
roboflow version restore my-workspace/my-detector/3
```

상위 프로젝트는 활성 상태여야 합니다(프로젝트 자체가 휴지통에 있으면 안 됨). 필요한 경우 먼저 프로젝트를 복원하세요.

### 워크플로 삭제

워크플로를 휴지통으로 이동:

```bash
roboflow workflow delete <workflow>
```

예:

```bash
roboflow workflow delete slow-webhooks
```

다음 옵션을 전달하세요: `--yes` (또는 `-y`)를 전달하면 확인 메시지를 건너뜁니다. 워크플로 URL 슬러그 또는 Firestore ID 중 하나를 전달할 수 있습니다.

### 워크플로 복원

```bash
roboflow workflow restore <workflow>
```

예:

```bash
roboflow workflow restore slow-webhooks
```

### 휴지통 항목 목록 조회

현재 워크스페이스 휴지통에 있는 항목을 모두 나열합니다:

```bash
roboflow trash list
```

```
TYPE       ID               NAME                              DELETED       CLEANUP_AT    BY
dataset    d_abc123         My Detector                       2026-04-20    2026-05-20    Alice
version    3                My Detector - augmented-416 (v3)  2026-04-21    2026-05-21    Bob
workflow   wf_def456        Preprocessing Pipeline            2026-04-19    2026-05-19    Alice
```

스크립트에서 사용하기 적합한 구조화된 출력을 확인하려면:

```bash
roboflow --json trash list
```

### 영구 삭제

영구 삭제 기능은 의도적으로 CLI나 SDK에서 제공하지 않습니다. 휴지통 비우기와 휴지통 항목 하나를 즉시 삭제하는 작업은 데이터를 복구할 수 없게 파괴하므로, 실수로 실행된 스크립트나 오타로 이러한 작업이 실행되지 않도록 했습니다. 이 작업은 명시적인 확인 대화상자가 표시되는 Roboflow 웹 앱의 휴지통 보기에서만 사용할 수 있습니다.

휴지통에 남아 있는 항목은 30일 보관 기간이 지나면 자동으로 정리되므로, 일반적으로 직접 처리할 필요가 없습니다.

## MCP 서버

AI 에이전트를 다음에 연결하면 [MCP 서버](https://docs.roboflow.com/get-started/ko/agents/mcp-server.md) 다음 도구를 사용해 삭제한 항목을 복원할 수 있습니다:

<table data-search="false"><thead><tr><th width="290">도구</th><th>설명</th></tr></thead><tbody><tr><td><code>trash_list</code></td><td>현재 워크스페이스 휴지통에 있는 소프트 삭제 항목을 나열합니다.</td></tr><tr><td><code>trash_restore_project</code></td><td>삭제된 프로젝트를 복원합니다.</td></tr><tr><td><code>trash_restore_version</code></td><td>삭제된 데이터셋 버전을 복원합니다.</td></tr><tr><td><code>trash_restore_workflow</code></td><td>삭제된 워크플로를 복원합니다.</td></tr><tr><td><code>trash_restore_training</code></td><td>삭제된 학습 실행을 복원합니다.</td></tr></tbody></table>
