휴지통

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

소개

삭제된 프로젝트, 데이터셋 버전, 트레이닝, 워크플로는 영구적으로 제거되기 전에 30일 동안 작업공간의 휴지통으로 이동됩니다. 30일 보존 기간 내에는 언제든지 휴지통에서 항목을 복원할 수 있으며, 더 이상 필요하지 않다고 확신하는 경우 즉시 영구 삭제할 수도 있습니다.

웹 앱

휴지통 열기

작업공간의 설정으로 이동한 다음 하위 탐색에서 휴지통을 선택하세요. 이 페이지에는 삭제된 모든 프로젝트, 버전, 트레이닝, 워크플로가 유형별로 묶여 표시되며, 각 항목을 삭제한 사람, 삭제 시점, 영구 정리까지 남은 일수도 함께 나옵니다.

항목 복원

한 행의 복원을 클릭하여 해당 항목을 복원하거나, 체크박스로 여러 항목을 선택한 뒤 복원을 클릭해 한 번에 모두 복원할 수 있습니다. 모두 복원은 작업공간 휴지통의 모든 항목을 복원합니다.

복원된 항목은 삭제되었던 동일한 위치로 작업공간에 즉시 다시 나타납니다. 데이터셋 버전은 상위 프로젝트가 아직 활성 상태일 때만 복원할 수 있습니다. 상위 프로젝트도 휴지통에 있다면 먼저 프로젝트를 복원한 다음 해당 버전을 복원하세요. 트레이닝도 마찬가지로, 먼저 상위 프로젝트와 버전을 복원해야 합니다.

항목 영구 삭제

30일 보존 기간을 건너뛰고 항목을 바로 제거하려면 한 행에서 영구 삭제를 클릭하거나 여러 항목을 선택한 다음 영구 삭제를 클릭하세요. 휴지통 비우기는 작업공간 휴지통의 모든 항목을 한 번에 제거합니다. 영구 삭제는 되돌릴 수 없습니다.

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

삭제하면 무슨 일이 일어나나요

프로젝트, 버전, 트레이닝 또는 워크플로가 삭제되면:

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

프로젝트를 삭제할 때 "Asset Library의 이미지도 삭제"를 체크했다면, 휴지통 행의 호박색 표시기는 해당 프로젝트에만 속한 이미지도 프로젝트가 영구 정리될 때 함께 제거됨을 나타냅니다. 다른 프로젝트와 공유되는 이미지는 항상 보존됩니다.

누가 휴지통을 사용할 수 있나요

휴지통과 그 작업에 대한 접근은 역할 기반 접근 제어로 관리됩니다. 기본 Owner 역할에는 모든 휴지통 권한이 부여됩니다. 개별 휴지통 권한(view_trash, trash_dataset, restore_dataset, trash_version, restore_version, trash_training, restore_training, delete_training, trash_workflow, restore_workflow)을 작업공간의 역할 기반 접근 제어 설정에서 사용자 지정 역할에 할당할 수 있습니다.

HTTP API

휴지통으로 이동된 프로젝트와 데이터셋 버전은 영구적으로 정리되기 전 30일 동안 보존됩니다. REST API를 통해 항목을 삭제, 목록 조회, 복원할 수 있으며, 영구 삭제는 웹 UI에서만 가능합니다(하단의 영구 삭제 참고를 보세요).

프로젝트나 버전에 대해 진행 중이던 트레이닝 작업은 항목이 휴지통으로 이동될 때 자동으로 취소됩니다.

프로젝트 삭제

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

https://api.roboflow.com/:workspace/:project

curl "https://api.roboflow.com/my-workspace/my-detector?api_key=$ROBOFLOW_API_KEY" \\
  -X DELETE

예시 응답:

{
  "deleted": true,
  "type": "project",
  "workspace": "my-workspace",
  "project": "my-detector",
  "projectId": "d_abc123",
  "trash": true
}

호출하는 API 키에는 project:update 스코프가 있어야 합니다.

버전 삭제

단일 데이터셋 버전을 휴지통으로 이동:

https://api.roboflow.com/:workspace/:project/:version

curl "https://api.roboflow.com/my-workspace/my-detector/3?api_key=$ROBOFLOW_API_KEY" \\
  -X DELETE

예시 응답:

{
  "deleted": true,
  "type": "version",
  "workspace": "my-workspace",
  "project": "my-detector",
  "projectId": "d_abc123",
  "version": "3",
  "trash": true
}

호출하는 API 키에는 version:update 스코프가 있어야 합니다.

워크플로 삭제

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

https://api.roboflow.com/:workspace/workflows/:workflowUrl

curl "https://api.roboflow.com/my-workspace/workflows/slow-webhooks?api_key=$ROBOFLOW_API_KEY" \\
  -X DELETE

예시 응답:

{
  "deleted": true,
  "type": "workflow",
  "workspace": "my-workspace",
  "workflow": "slow-webhooks",
  "workflowId": "wf_abc123",
  "trash": true
}

호출하는 API 키에는 workflow:update 스코프가 있어야 합니다.

휴지통의 항목 목록 보기

현재 작업공간 휴지통에 있는 모든 항목을 나열:

https://api.roboflow.com/:workspace/trash

curl "https://api.roboflow.com/my-workspace/trash?api_key=$ROBOFLOW_API_KEY"

예시 응답:

{
  "items": [
    {
      "type": "project",
      "id": "d_abc123",
      "name": "My Detector",
      "url": "my-detector",
      "deletedAt": "2026-04-20T17:05:33.000Z",
      "scheduledCleanupAt": "2026-05-20T17:05:33.000Z",
      "deletedBy": "uid-of-user",
      "deletedByName": "Alice"
    },
    {
      "type": "version",
      "id": "3",
      "name": "augmented-416",
      "parentId": "d_xyz789",
      "parentName": "My Other Project",
      "parentUrl": "my-other-project",
      "parentInTrash": false,
      "deletedAt": "2026-04-21T12:14:02.000Z",
      "scheduledCleanupAt": "2026-05-21T12:14:02.000Z"
    }
  ],
  "sections": {
    "projects": [ ... ],
    "versions": [ ... ],
    "workflows": [ ... ],
    "trainings": [ ... ]
  }
}

각 항목에는 scheduledCleanupAt 타임스탬프가 포함됩니다. 이는 해당 항목이 영구 정리 대상이 되는 시점을 의미합니다. 프로젝트에는 또한 cleanupDeleteImages 불리언이 포함되어, 정리 실행 시 프로젝트에만 속한 이미지도 함께 삭제될지 여부를 나타냅니다.

호출하는 API 키에는 project:read 스코프가 있어야 합니다.

항목 복원

휴지통에서 프로젝트, 버전, 트레이닝 또는 워크플로를 복원:

https://api.roboflow.com/:workspace/trash/restore

curl "https://api.roboflow.com/my-workspace/trash/restore?api_key=$ROBOFLOW_API_KEY" \\
  -X POST \\
  -H "Content-Type: application/json" \
  -d '{"type": "project", "id": "d_abc123"}'

버전의 경우 상위 프로젝트 ID도 포함해야 합니다:

curl "https://api.roboflow.com/my-workspace/trash/restore?api_key=$ROBOFLOW_API_KEY" \\
  -X POST \\
  -H "Content-Type: application/json" \
  -d '{"type": "version", "id": "3", "parentId": "d_abc123"}'

버전을 복원하려면 상위 프로젝트가 여전히 활성 상태여야 합니다(즉, 휴지통에 있으면 안 됩니다). 상위 프로젝트도 휴지통에 있다면 먼저 복원하세요. 트레이닝을 복원하려면 해당 프로젝트와 버전이 모두 활성 상태여야 합니다.

type 다음 중 하나여야 합니다 project, version, training, 또는 workflow. 필요한 API 키 스코프는 항목 유형별 - 복원 중인 항목에 대해 올바른 스코프가 없으면 요청은 401로 실패합니다:

type

필수 스코프

project

project:update

version

version:update

training

version:update

workflow

workflow:update

또한 엔드포인트는 targetItem.owner === :workspace 를 위임하기 전에 검증하므로, 작업공간 A에서 유효한 키로 작업공간 B에 있는 항목은 복원할 수 없습니다.

영구 삭제

REST API에서는 의도적으로 영구 삭제를 사용할 수 없습니다. 휴지통 비우기와 단일 휴지통 항목 즉시 삭제는 데이터를 복구 불가능하게 파괴하므로, 실수로 실행된 curl이나 자동화가 이를 트리거하지 못하게 하려는 것입니다. 이러한 작업은 명시적인 확인이 있는 Roboflow 웹 앱의 휴지통 보기에서만 사용할 수 있습니다.

휴지통에 남아 있는 항목은 30일 보존 기간이 지나면 자동으로 정리됩니다.

Python SDK

Python SDK를 통해 삭제된 프로젝트와 데이터셋 버전은 작업공간의 휴지통 으로 이동되며, 영구적으로 정리되기 전 30일 동안 보존됩니다. 보존 기간 내에는 이를 작업공간으로 다시 복원할 수 있습니다.

프로젝트나 버전에 연관된 진행 중 트레이닝 작업은 항목이 휴지통으로 이동될 때 자동으로 취소되므로, 크레딧을 계속 사용하지 않게 됩니다.

프로젝트 삭제

import roboflow

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

project.delete()

프로젝트는 작업공간 프로젝트 목록에서 즉시 숨겨지며 설정 → 휴지통 아래의 휴지통 보기에 표시됩니다.

프로젝트 복원

아직 프로젝트 객체에 대한 참조가 있다면, restore() 를 호출하세요:

project.restore()

SDK는 슬러그를 기준으로 작업공간 휴지통에서 프로젝트를 찾아 복원합니다. RuntimeError 프로젝트가 현재 휴지통에 없으면 발생합니다.

버전 삭제

단일 데이터셋 버전을 휴지통으로 이동합니다. 해당 버전에 대해 진행 중인 트레이닝은 취소됩니다.

import roboflow

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

version.delete()

버전 복원

version.restore()

버전을 복원하려면 상위 프로젝트가 여전히 활성 상태여야 합니다(즉, 휴지통에 있으면 안 됩니다). 필요하면 먼저 프로젝트를 복원하세요.

휴지통의 항목 목록 보기

사용 Workspace.trash() 를 사용해 현재 작업공간 휴지통에 무엇이 있는지 확인하세요:

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"] 는 동일한 항목을 다음 기준으로 묶습니다 프로젝트, 버전와 워크플로 편의를 위해.

ID로 복원

이미 프로젝트 또는 버전 핸들이 없다면(예: 이전 세션에서 삭제된 항목을 복원하는 경우), Workspace.restore_from_trash() 의 반환값에 있는 ID를 사용하세요. trash():

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

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

버전의 경우 상위 프로젝트 ID를 전달하세요:

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

워크플로

SDK는 현재 워크플로 객체를 노출하지 않지만, 저수준 rfapi 헬퍼를 통해 워크플로를 소프트 삭제하고 Workspace.restore_from_trash("workflow", ...):

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일 동안 보존됩니다. 보존 기간 내에는 이를 작업공간으로 다시 복원할 수 있습니다.

프로젝트나 버전에 연결된 진행 중 트레이닝 작업은 항목이 휴지통으로 이동될 때 자동으로 취소되므로, 삭제하는 항목에 크레딧을 계속 사용하지 않게 됩니다.

프로젝트 삭제

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

roboflow project delete <workspace>/<project>

예시:

roboflow project delete my-workspace/my-detector

이 명령은 프로젝트를 이동하기 전에 확인을 요청합니다. 스크립트에서 사용하려면 --yes (또는 -y)를 전달해 확인 프롬프트를 건너뛸 수 있습니다:

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

프로젝트 복원

roboflow project restore <workspace>/<project>

예시:

roboflow project restore my-workspace/my-detector

CLI는 슬러그를 기준으로 작업공간 휴지통에서 프로젝트를 찾아 복원합니다. 프로젝트가 현재 휴지통에 없으면 명령은 오류로 종료됩니다.

버전 삭제

단일 데이터셋 버전을 휴지통으로 이동합니다. 해당 버전에 대해 진행 중인 트레이닝은 취소됩니다.

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

예시:

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

확인을 건너뛰려면 --yes 를 전달하세요.

버전 복원

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

예시:

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

상위 프로젝트는 여전히 활성 상태여야 합니다(즉, 휴지통에 있으면 안 됩니다) - 필요하면 먼저 프로젝트를 복원하세요.

워크플로 삭제

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

roboflow workflow delete <workflow>

예시:

roboflow workflow delete slow-webhooks

확인을 건너뛰려면 --yes (또는 -y)를 전달해 확인 프롬프트를 건너뛸 수 있습니다. 워크플로 URL 슬러그 또는 Firestore ID 중 어느 것이든 전달할 수 있습니다.

워크플로 복원

roboflow workflow restore <workflow>

예시:

roboflow workflow restore slow-webhooks

휴지통의 항목 목록 보기

현재 작업공간 휴지통에 있는 모든 항목을 나열:

roboflow trash list

유형       ID               이름                              삭제됨       정리_AT    작성자
데이터셋    d_abc123         My Detector                       2026-04-20    2026-05-20    Alice
버전       3                My Detector - augmented-416 (v3)  2026-04-21    2026-05-21    Bob
워크플로   wf_def456        Preprocessing Pipeline            2026-04-19    2026-05-19    Alice

스크립트용 구조화된 출력은 다음과 같습니다:

roboflow --json trash list

영구 삭제

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

휴지통에 남아 있는 항목은 30일 보존 기간이 지나면 자동으로 정리되므로, 수동으로 조치해야 하는 경우는 드뭅니다.

이전작업 공간 만들기 다음팀원

마지막 업데이트 15일 전

도움이 되었나요?