> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/jp/idoyobiakusesuiam/apidokyumento-scim/yzapi/yzwo-2.md).

# ユーザーを更新

## ユーザーのPATCH更新

### 概要

この `PATCH /Users/{id}` エンドポイントは、ユーザーに対して部分更新を行うために使用されます。

この実装は **限定的なPATCH機能** をサポートしており、主にユーザーの役割を更新するために使用されます。

Okta や Microsoft Azure Active Directory などの ID プロバイダーは、ユーザーのライフサイクル更新の際にこのエンドポイントを使用する場合があります。

***

### サポートされる操作

サポートされるのは次の操作のみです:

* ユーザーの役割を更新

その他のPATCH操作はすべて **サポートされていません**.

***

### エンドポイント

```bash
PATCH /Users/{id}
```

***

### 完全なURL

```bash
https://api.ggwp.com/scim/v2/Users/{id}
```

***

### 認証

```http
Authorization: Bearer <access_token>
```

***

## リクエスト本文

### サポートされるスキーマ

```json
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"]
}
```

***

### リクエスト例（役割の更新）

```json
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [
    {
      "op": "replace",
      "path": "roles",
      "value": [
        {
          "value": "moderator"
        }
      ]
    }
  ]
}
```

***

## 許可される値

### 役割

* **型:** `文字列`
* **許可される値:**
  * `admin`
  * `moderator`

***

## レスポンス

### 成功（200 OK）

```json
{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "id": "c118d158-c11b-495b-ab88-f57c8ac473c0",
  "userName": "Temp_user_prod",
  "externalId": "ABC1900BE",
  "active": true,
  "name": {
    "givenName": "Temp",
    "familyName": "User"
  },
  "displayName": "一時ユーザー",
  "emails": [
    {
      "value": "temp_user_us@example.com",
      "primary": true
    }
  ],
  "roles": [
    {
      "value": "admin"
    }
  ],
  "meta": {
    "resourceType": "User",
    "location": "https://api.ggwp.com/scim/v2/Users/c118d158-c11b-495b-ab88-f57c8ac473c0",
    "created": "2026-04-01T11:15:22Z",
    "lastModified": "2026-04-01T11:15:22Z"
  }
}
```

***

## エラーレスポンス

### 400 Bad Request（サポートされていない操作）

```json
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "status": "400",
  "detail": "役割の更新のみサポートされています"
}
```

***

### 400 Bad Request（無効な役割）

```json
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "status": "400",
  "detail": "役割の値が無効です"
}
```

***

### 404 Not Found

```json
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "status": "404",
  "detail": "ユーザーが見つかりません"
}
```

***

## 検証ルール

* のみ `置換` 操作がサポートされています
* のみ `path = "roles"` がサポートされています
* `値` 以下のいずれかである必要があります:
  * `admin`
  * `moderator`
* その他のPATCHリクエストはすべて拒否されます