# 워크스페이스 (Workspaces) API

## 엔드포인트 목록

| 메서드 | 경로 | 설명 |
|--------|------|------|
| GET | /openapi/v1/workspaces | 워크스페이스 목록 조회 |
| POST | /openapi/v1/workspaces | 워크스페이스 생성 |
| PATCH | /openapi/v1/workspaces/{workspaceId} | 워크스페이스 이름 변경 |

## GET /openapi/v1/workspaces

API Key 또는 OAuth2 토큰이 속한 마스터의 워크스페이스 목록을 조회합니다.

### 응답 (200)

```json
{
  "data": {
    "workspaces": [
      {
        "workspaceId": "ws_abc123",
        "workspaceName": "2026 SS 컬렉션",
        "createdAt": "2026-03-01T09:00:00Z"
      }
    ]
  }
}
```

### 예시

```bash
curl -H "X-API-Key: YOUR_KEY" \
  https://openapi.gency.ai/openapi/v1/workspaces
```

## POST /openapi/v1/workspaces

새로운 워크스페이스를 생성합니다.

### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
|------|------|------|------|
| name | string | Y | 워크스페이스 이름 (최대 100자) |

```json
{ "name": "신상품 촬영" }
```

### 응답 (200)

```json
{
  "data": {
    "workspaceId": "ws_def456",
    "workspaceName": "신상품 촬영",
    "createdAt": "2026-04-09T10:00:00Z"
  }
}
```

## PATCH /openapi/v1/workspaces/{workspaceId}

워크스페이스의 이름을 변경합니다.

### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
|------|------|------|------|------|
| workspaceId | path | string | Y | 워크스페이스 ID |

### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
|------|------|------|------|
| name | string | Y | 새 워크스페이스 이름 (최대 100자) |

```bash
curl -X PATCH \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "2026 FW 컬렉션"}' \
  https://openapi.gency.ai/openapi/v1/workspaces/ws_abc123
```