---
title: "사용자 정보 수정"
method: PUT
path: "/api/v1/users/{id}"
tags: ["사용자"]
---

# 사용자 정보 수정

`PUT /api/v1/users/{id}`

사용자의 이름 또는 역할을 수정합니다.

### 사용처
- 사용자 이름 변경
- 사용자 역할 변경

### 제약 조건
- name과 role 중 하나 이상 필수
- name: 1~100자 (null이면 변경하지 않음)
- role: USER, DESIGNER, MANAGER, ADMIN 중 선택 (null이면 변경하지 않음)

## Path parameters

- `id` string, required

## Request body

- UpdateUserRequest
  - `name` string — 변경할 이름 (null이면 변경하지 않음)
  - `role` 'USER' | 'DESIGNER' | 'MANAGER' | 'ADMIN' — 변경할 역할 (null이면 변경하지 않음)

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- ApiResponseUnit
  - `result` 'SUCCESS' | 'FAIL', required — 응답 결과 타입
  - `data` unknown
  - `error` ErrorMessage
    - `errorCode` 'INTERNAL_ERROR' | 'BAD_REQUEST' | 'NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN' — 에러 코드
    - `message` string — 에러 메시지

---

[API](https://skmtc.dev/archisketch/apis/open-api.md) · [All operations](https://skmtc.dev/archisketch/apis/open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archisketch/open-api/revisions/f6b0eda1a99d/schema)