> 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/list-workspaces-and-projects.md).

# 워크스페이스 및 프로젝트 목록 보기

REST API, Python SDK, CLI를 사용하여 워크스페이스, 프로젝트, 버전, 학습된 모델을 나열하세요.

## 개요

workspace 엔드포인트는 Workspace와 그 안의 모든 Project를 반환하며, 각 Project의 유형, 이미지 및 주석 수, 버전, 분할 정보도 포함합니다. 데이터를 업로드하거나 버전을 내보내기 전에 Project ID를 찾고, 이후 Project의 버전과 학습된 모델을 조회하는 데 사용하세요. 동일한 데이터는 HTTP API, Python SDK, CLI에서도 이용할 수 있습니다.

## HTTP API

### Project 목록 조회

API 키가 속한 Workspace의 Project를 반환합니다.

{% openapi src="/files/79520a8f5b330a0219b18d49627ee6770d498da0" path="/{workspace}" method="get" %}
[workspaces.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-cca0758f0149fdf0990e84e895042d80106b9955%2Fworkspaces.yaml?alt=media)
{% endopenapi %}

### Project 조회 및 버전 목록 확인

Project와 해당 버전을 최신순으로 반환합니다. 각 버전에는 해당 버전으로 학습한 모델이 있는 경우 그 모델도 포함됩니다.

{% openapi src="/files/79520a8f5b330a0219b18d49627ee6770d498da0" path="/{workspace}/{project}" method="get" %}
[workspaces.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-cca0758f0149fdf0990e84e895042d80106b9955%2Fworkspaces.yaml?alt=media)
{% endopenapi %}

### Project 모델 목록 조회

Project의 모든 학습된 모델을 반환합니다. 여기에는 다음의 모델도 포함됩니다: [신경망 아키텍처 검색](https://docs.roboflow.com/models/train/neural-architecture-search) 실행. 한 번의 실행에서 모델을 조회하려면 `group` 를 전달하세요.

다음을 사용하는 경우: [Roboflow로 로그인](https://docs.roboflow.com/reference/authentication/authentication/sign-in-with-roboflow-getting-started), 액세스 토큰을 `Authorization: Bearer` 헤더에 전달하고, `model:infer` 범위를 사용하세요. 이 경우 `api_key`.

{% openapi src="/files/79520a8f5b330a0219b18d49627ee6770d498da0" path="/{workspace}/{project}/models" method="get" %}
[workspaces.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-cca0758f0149fdf0990e84e895042d80106b9955%2Fworkspaces.yaml?alt=media)
{% endopenapi %}

## Python SDK

다음과 같이 API 키가 인증하는 workspace의 `Workspace` 핸들을 가져오세요:

```python
import roboflow

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

각 Roboflow API 키는 단일 workspace에 범위가 한정됩니다. 다른 workspace에서 작업하려면 다른 API 키를 사용하세요(또는 공개 Universe workspace의 경우 workspace 슬러그를 전달하세요):

```python
# 공개 Universe workspace - API 키만 필요합니다.
public_ws = rf.workspace("roboflow-100")
```

### Workspace 속성

반환된 `Workspace` 에는 다음 항목이 제공됩니다:

* `workspace.url` - workspace의 URL 슬러그(예: `my-workspace`).
* `workspace.name` - workspace에 표시되는 이름입니다.
* `workspace.list_projects()` - workspace의 프로젝트를 딕셔너리 목록으로 반환합니다.
* `workspace.projects()` - 와 동일한 데이터를 반환하지만, `list_projects()` 를 `Project` 객체 목록으로 반환합니다(이전 별칭).
* `workspace.list_folders()` - 참조: [폴더 관리](https://docs.roboflow.com/datasets/manage/project-folders#python-sdk).
* `workspace.list_workflows()` - 참조: [워크플로 관리](https://docs.roboflow.com/workflows/manage/manage-workflows#python-sdk).
* `workspace.get_plan()` 및 `workspace.get_usage()` - 자세한 내용은 [워크스페이스 요금제 및 사용량](https://docs.roboflow.com/get-started/ko/platform/billing-and-plans/view-credit-usage.md#python-sdk).

### 프로젝트 및 버전 나열

#### Project 목록 조회

워크스페이스의 프로젝트를 가져옵니다.

```python
import roboflow

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

for project in workspace.list_projects():
    print(project["id"], project["name"], project["type"])
```

각 항목에는 프로젝트 ID(URL 슬러그), 표시 이름, 프로젝트 유형, 이미지 수 및 기타 메타데이터가 포함됩니다.

공개 Universe 워크스페이스에서 작업하려면 해당 슬러그를 전달합니다.

```python
universe_ws = rf.workspace("roboflow-100")
```

#### 프로젝트 가져오기

```python
project = workspace.project("my-detector")
```

또는 최상위 바로 가기를 사용합니다.

```python
project = rf.project("my-detector")
```

#### 버전 나열

```python
for version in project.versions():
    print(version.version, version.name)
```

`project.versions()` 는 `Version` 객체를 반환하며, 이 객체에서 메서드를 직접 호출할 수 있습니다(`download`, `train`, `delete`등). 경량 딕셔너리 응답을 사용하려면 `project.list_versions()` 또는 `project.get_version_information()`.

#### 버전 가져오기

```python
version = project.version(3)
```

숫자 값을 사용합니다. 버전은 1부터 시작합니다.

## CLI

### 워크스페이스 나열

CLI를 사용하면 자신이 구성원인 모든 워크스페이스의 목록을 가져올 수 있습니다.

CLI로 워크스페이스를 나열하려면 다음 명령을 사용합니다.

<pre class="language-bash"><code class="lang-bash"><strong>roboflow workspace list
</strong></code></pre>

이 명령은 해당 애플리케이션 링크 및 워크스페이스 ID와 함께 워크스페이스 목록을 반환합니다.

```
NAME             ID               DEFAULT
My Workspace     my-workspace     *
Other Workspace  other-ws
```

JSON 형식으로 출력하려면(스크립트 또는 AI 에이전트에서 사용):

```bash
roboflow workspace list --json
```

```json
[
  {"name": "My Workspace", "url": "my-workspace", "link": "https://app.roboflow.com/my-workspace", "default": true},
  {"name": "Other Workspace", "url": "other-ws", "link": "https://app.roboflow.com/other-ws", "default": false}
]
```

### 워크스페이스의 프로젝트 나열

워크스페이스의 프로젝트를 나열하려면 다음 명령을 사용합니다.

```bash
roboflow project list
```

기본 워크스페이스가 구성되어 있으면 `-w` 플래그는 생략할 수 있습니다. 그렇지 않으면 다음과 같이 지정합니다.

```bash
roboflow project list -w WORKSPACE_ID
```

프로젝트 표가 반환됩니다.

```
NAME              ID                              TYPE                VERSIONS  IMAGES
my-dataset        my-workspace/my-dataset         object-detection    3         500
classifier        my-workspace/classifier         classification      1         200
```

출력을 JSON 형식으로 가져오려면 다음을 실행하세요.

```bash
roboflow project list --json
```

### 프로젝트 가져오기

프로젝트에 대한 자세한 정보를 보려면 다음 명령을 사용하세요.

```bash
roboflow project get PROJECT_ID
```

리소스 약칭을 사용할 수 있으므로 워크스페이스를 별도로 지정할 필요가 없습니다.

```bash
roboflow project get my-dataset              # uses default workspace
roboflow project get my-workspace/my-dataset  # explicit workspace
```

프로젝트의 버전을 포함한 정보가 반환됩니다.

```
프로젝트: my-dataset
  ID: my-workspace/my-dataset
  유형: object-detection
  이미지: 500
  버전: 3
  클래스: car (200), truck (150), bus (150)
  링크: https://app.roboflow.com/my-workspace/my-dataset
```

전체 JSON 응답을 가져오려면 다음을 실행하세요.

```bash
roboflow project get my-dataset --json
```

## 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>projects_list</code></td><td>워크스페이스의 프로젝트 목록을 가져옵니다.</td></tr><tr><td><code>projects_get</code></td><td>버전, 클래스, 데이터 분할, 학습된 모델을 포함한 프로젝트 세부 정보를 가져옵니다.</td></tr></tbody></table>
