{
  "components": {
    "responses": {},
    "schemas": {
      "Error": {
        "description": "2xx以外のレスポンスで返すエラー。",
        "properties": {
          "error": {
            "description": "エラーコード。invalid_token、forbidden、not_found、invalid_request、rate_limit_exceeded、rate_limit_unavailable、authentication_unavailable、service_unavailableのいずれか。",
            "type": "string"
          },
          "message": {
            "description": "エラーの説明。",
            "type": "string"
          }
        },
        "required": [
          "error",
          "message"
        ],
        "title": "Error",
        "type": "object"
      },
      "Group": {
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "title": "Group",
        "type": "object"
      },
      "GroupCreateRequest": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "1〜128文字。前後の空白と`/`を含めない。",
            "maxLength": 128,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "GroupCreateRequest",
        "type": "object"
      },
      "GroupCreateResponse": {
        "properties": {
          "group": {
            "$ref": "#/components/schemas/Group"
          },
          "requestId": {
            "type": "string"
          },
          "status": {
            "description": "組織に同じ名前のグループがすでにある場合は`existing`。",
            "enum": [
              "created",
              "existing"
            ],
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "status",
          "group"
        ],
        "title": "GroupCreateResponse",
        "type": "object"
      },
      "GroupDeleteResponse": {
        "properties": {
          "group": {
            "$ref": "#/components/schemas/Group"
          },
          "requestId": {
            "type": "string"
          },
          "status": {
            "enum": [
              "deleted"
            ],
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "status",
          "group"
        ],
        "title": "GroupDeleteResponse",
        "type": "object"
      },
      "GroupListResponse": {
        "properties": {
          "groups": {
            "items": {
              "$ref": "#/components/schemas/Group"
            },
            "type": "array"
          },
          "requestId": {
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "groups"
        ],
        "title": "GroupListResponse",
        "type": "object"
      },
      "GroupMember": {
        "properties": {
          "userId": {
            "type": "string"
          }
        },
        "required": [
          "userId"
        ],
        "title": "GroupMember",
        "type": "object"
      },
      "GroupMembersResponse": {
        "properties": {
          "groupId": {
            "type": "string"
          },
          "members": {
            "items": {
              "$ref": "#/components/schemas/GroupMember"
            },
            "type": "array"
          },
          "requestId": {
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "groupId",
          "members"
        ],
        "title": "GroupMembersResponse",
        "type": "object"
      },
      "GroupMembership": {
        "properties": {
          "groupId": {
            "type": "string"
          },
          "member": {
            "description": "リクエスト後の所属状態。",
            "type": "boolean"
          },
          "userId": {
            "type": "string"
          }
        },
        "required": [
          "groupId",
          "userId",
          "member"
        ],
        "title": "GroupMembership",
        "type": "object"
      },
      "GroupMembershipResponse": {
        "properties": {
          "membership": {
            "$ref": "#/components/schemas/GroupMembership"
          },
          "requestId": {
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "membership"
        ],
        "title": "GroupMembershipResponse",
        "type": "object"
      },
      "NullableRole": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Role"
          }
        ],
        "description": "ルームロール。直接割り当てられていない場合はnull。",
        "nullable": true,
        "title": "NullableRole",
        "type": "object"
      },
      "OrganizationRoleAssignment": {
        "description": "ユーザーの組織ロール。組織に所属するユーザーには常にロールがある。",
        "properties": {
          "organizationId": {
            "type": "string"
          },
          "role": {
            "$ref": "#/components/schemas/Role"
          },
          "subjectId": {
            "description": "ユーザーID。",
            "type": "string"
          },
          "target": {
            "enum": [
              "user"
            ],
            "type": "string"
          }
        },
        "required": [
          "target",
          "organizationId",
          "subjectId",
          "role"
        ],
        "title": "OrganizationRoleAssignment",
        "type": "object"
      },
      "OrganizationRoleAssignmentResponse": {
        "properties": {
          "assignment": {
            "$ref": "#/components/schemas/OrganizationRoleAssignment"
          },
          "requestId": {
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "assignment"
        ],
        "title": "OrganizationRoleAssignmentResponse",
        "type": "object"
      },
      "OrganizationRoleAssignmentUpdateRequest": {
        "additionalProperties": false,
        "properties": {
          "ifRoleId": {
            "description": "現在のロールIDがこの値の場合だけ変更する。一致しない場合はHTTP 200で`status: unchanged`、`reason: role_changed_by_other`を返し、変更しない。",
            "format": "int64",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "roleId": {
            "format": "int64",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "roleId"
        ],
        "title": "OrganizationRoleAssignmentUpdateRequest",
        "type": "object"
      },
      "OrganizationRoleAssignmentUpdateResponse": {
        "properties": {
          "assignment": {
            "$ref": "#/components/schemas/OrganizationRoleAssignment"
          },
          "reason": {
            "description": "`ifRoleId`が現在のロールと一致しなかった場合に含まれる。",
            "enum": [
              "role_changed_by_other"
            ],
            "type": "string"
          },
          "requestId": {
            "type": "string"
          },
          "status": {
            "enum": [
              "updated",
              "unchanged"
            ],
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "status",
          "assignment"
        ],
        "title": "OrganizationRoleAssignmentUpdateResponse",
        "type": "object"
      },
      "Role": {
        "properties": {
          "id": {
            "format": "int64",
            "minimum": 0,
            "type": "integer"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "title": "Role",
        "type": "object"
      },
      "RoomRoleAssignment": {
        "description": "ルームで対象に直接割り当てられたロール。",
        "properties": {
          "role": {
            "$ref": "#/components/schemas/NullableRole"
          },
          "roomId": {
            "description": "ルームID。",
            "type": "string"
          },
          "subjectId": {
            "description": "ユーザーIDまたはグループID。対象がユーザーかグループの場合だけ含まれる。",
            "type": "string"
          },
          "target": {
            "$ref": "#/components/schemas/RoomRoleAssignmentTarget"
          }
        },
        "required": [
          "target",
          "roomId",
          "role"
        ],
        "title": "RoomRoleAssignment",
        "type": "object"
      },
      "RoomRoleAssignmentResponse": {
        "properties": {
          "assignment": {
            "$ref": "#/components/schemas/RoomRoleAssignment"
          },
          "requestId": {
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "assignment"
        ],
        "title": "RoomRoleAssignmentResponse",
        "type": "object"
      },
      "RoomRoleAssignmentTarget": {
        "enum": [
          "user",
          "group",
          "authenticated_default",
          "anonymous"
        ],
        "title": "RoomRoleAssignmentTarget",
        "type": "string"
      },
      "RoomRoleAssignmentUpdateRequest": {
        "additionalProperties": false,
        "properties": {
          "ifRoleId": {
            "description": "現在の直接割当のロールIDがこの値の場合だけ変更する。一致しない場合はHTTP 200で`status: unchanged`、`reason: role_changed_by_other`を返し、変更しない。",
            "format": "int64",
            "maximum": 9223372036854775807,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "roleId": {
            "description": "設定するルームロールID。nullを指定すると直接割当を解除する。",
            "format": "int64",
            "maximum": 9223372036854775807,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          }
        },
        "required": [
          "roleId"
        ],
        "title": "RoomRoleAssignmentUpdateRequest",
        "type": "object"
      },
      "RoomRoleAssignmentUpdateResponse": {
        "properties": {
          "assignment": {
            "$ref": "#/components/schemas/RoomRoleAssignment"
          },
          "reason": {
            "description": "`ifRoleId`が現在のロールと一致しなかった場合に含まれる。",
            "enum": [
              "role_changed_by_other"
            ],
            "type": "string"
          },
          "requestId": {
            "type": "string"
          },
          "status": {
            "enum": [
              "updated",
              "unchanged",
              "cleared"
            ],
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "status",
          "assignment"
        ],
        "title": "RoomRoleAssignmentUpdateResponse",
        "type": "object"
      },
      "UserGroupsResponse": {
        "properties": {
          "groups": {
            "items": {
              "$ref": "#/components/schemas/Group"
            },
            "type": "array"
          },
          "requestId": {
            "type": "string"
          },
          "userId": {
            "type": "string"
          }
        },
        "required": [
          "requestId",
          "userId",
          "groups"
        ],
        "title": "UserGroupsResponse",
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "bearerFormat": "JWT",
        "description": "外部APIクライアントのアクセストークン（`client_credentials`で取得）。",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "外部APIクライアントから、ルームロール、組織ロール、グループ、グループ所属を操作するAPIです。\n\n## 認証\nすべてのリクエストに`Authorization: Bearer <アクセストークン>`を付けます。アクセストークンは、管理画面に表示されるtoken endpointから、`client_credentials`と`private_key_jwt`（ES256）で取得します。手順は[認証とアクセストークンの取得](https://docs.metatell.io/docs/developer-docs/external-api-clients/authentication)を参照してください。\n\n各APIには、説明に記載したスコープをクライアントに付与しておく必要があります。`organization_id`には、クライアントが所属する組織のIDを指定します。\n\n## レート制限\n外部APIクライアントごとにレート制限があります。レスポンスの`ratelimit-limit`、`ratelimit-remaining`、`ratelimit-reset`ヘッダーで状況を確認できます。上限を超えると429を返し、`retry-after`ヘッダーに再試行までの秒数が入ります。\n\n## 再試行\n429、503、通信エラーのときは同じリクエストを再送できます。ロールの変更は値の設定、所属の変更は状態の設定、グループの作成は同じ名前の既存グループを返すため、再送しても結果は変わりません。ただし、最初のリクエストが反映済みだった場合、再送の応答は次のように初回と異なります。\n\n- `ifRoleId`付きのロール変更：`status: unchanged`、`reason: role_changed_by_other`を返します。`assignment.role`が指定したロール（解除の場合は`null`）になっていれば、変更は反映済みです。\n- グループの削除：404を返します。削除済みとして扱えます。\n\n## リクエストID\nすべてのレスポンスに`x-request-id`ヘッダーが付きます（20〜200文字の値をリクエストで指定することもできます）。成功時のレスポンスには同じ値が`requestId`として入ります。問い合わせの際はこの値をお知らせください。\n",
    "title": "metatell外部クライアント向けAPI",
    "version": "1.0.0"
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v3/organizations/{organization_id}/groups": {
      "get": {
        "callbacks": {},
        "description": "必要なスコープ：`groups:read`",
        "operationId": "listGroups",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GroupListResponse"
                }
              }
            },
            "description": "グループ一覧"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "グループ一覧を取得",
        "tags": [
          "グループ"
        ]
      },
      "post": {
        "callbacks": {},
        "description": "組織に同じ名前のグループがすでにある場合は、新しく作成せず、そのグループをHTTP 200、`status: existing`で返します。\n\n必要なスコープ：`groups:write`",
        "operationId": "createGroup",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GroupCreateRequest"
              }
            }
          },
          "description": "作成するグループ",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GroupCreateResponse"
                }
              }
            },
            "description": "同じ名前の既存グループ"
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GroupCreateResponse"
                }
              }
            },
            "description": "作成したグループ"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "グループを作成",
        "tags": [
          "グループ"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/groups/{group_id}": {
      "delete": {
        "callbacks": {},
        "description": "グループへの所属と、グループに割り当てられたルームロールも削除されます。削除済みのグループを指定すると404を返すため、再送で404を受け取った場合は削除済みとして扱えます。\n\n必要なスコープ：`groups:write`",
        "operationId": "deleteGroup",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "グループID。",
            "in": "path",
            "name": "group_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GroupDeleteResponse"
                }
              }
            },
            "description": "削除したグループ"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "グループを削除",
        "tags": [
          "グループ"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/groups/{group_id}/members": {
      "get": {
        "callbacks": {},
        "description": "必要なスコープ：`group_memberships:read`",
        "operationId": "listGroupMembers",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "グループID。",
            "in": "path",
            "name": "group_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GroupMembersResponse"
                }
              }
            },
            "description": "メンバー一覧"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "グループのメンバー一覧を取得",
        "tags": [
          "グループ所属"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/groups/{group_id}/members/{user_id}": {
      "delete": {
        "callbacks": {},
        "description": "`user_id`はUUID形式で指定します。\n\n必要なスコープ：`group_memberships:write`",
        "operationId": "removeGroupMember",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "グループID。",
            "in": "path",
            "name": "group_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ユーザーID。",
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GroupMembershipResponse"
                }
              }
            },
            "description": "リクエスト後の所属"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "グループへの所属を削除",
        "tags": [
          "グループ所属"
        ]
      },
      "put": {
        "callbacks": {},
        "description": "`user_id`はUUID形式で指定します。まだログインしたことがないユーザーも追加できます。\n\n必要なスコープ：`group_memberships:write`",
        "operationId": "addGroupMember",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "グループID。",
            "in": "path",
            "name": "group_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ユーザーID。",
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GroupMembershipResponse"
                }
              }
            },
            "description": "リクエスト後の所属"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "グループへの所属を追加",
        "tags": [
          "グループ所属"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/organization-role-assignments/users/{user_id}": {
      "get": {
        "callbacks": {},
        "description": "組織に所属済みのユーザーだけ取得できます。\n\n必要なスコープ：`organization_roles:user:read`",
        "operationId": "getUserOrganizationRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ユーザーID。",
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationRoleAssignmentResponse"
                }
              }
            },
            "description": "現在の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "ユーザーの組織ロールを取得",
        "tags": [
          "組織ロール"
        ]
      },
      "patch": {
        "callbacks": {},
        "description": "`roleId`は必須で、`null`は指定できません（組織ロールの解除には対応していません）。`ifRoleId`を指定すると、現在のロールが一致する場合だけ変更します。一致しない場合はHTTP 200で`status: unchanged`、`reason: role_changed_by_other`を返し、変更しません。\n\n必要なスコープ：`organization_roles:user:write`",
        "operationId": "updateUserOrganizationRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ユーザーID。",
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrganizationRoleAssignmentUpdateRequest"
              }
            }
          },
          "description": "変更内容",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationRoleAssignmentUpdateResponse"
                }
              }
            },
            "description": "リクエスト後の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "ユーザーの組織ロールを変更",
        "tags": [
          "組織ロール"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/rooms/{room_id}/room-role-assignments/anonymous": {
      "get": {
        "callbacks": {},
        "description": "直接割り当てられていない場合、`role`は`null`です。\n\n必要なスコープ：`room_roles:anonymous:read`",
        "operationId": "getAnonymousRoomRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ルームID（ルームURLに含まれるID）。",
            "in": "path",
            "name": "room_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomRoleAssignmentResponse"
                }
              }
            },
            "description": "現在の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "未ログインユーザーのルームロールを取得",
        "tags": [
          "ルームロール"
        ]
      },
      "patch": {
        "callbacks": {},
        "description": "`roleId`に`null`を指定すると直接割当を解除します。`ifRoleId`を指定すると、現在のロールが一致する場合だけ変更します。一致しない場合はHTTP 200で`status: unchanged`、`reason: role_changed_by_other`を返し、変更しません。\n\n必要なスコープ：`room_roles:anonymous:write`",
        "operationId": "updateAnonymousRoomRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ルームID（ルームURLに含まれるID）。",
            "in": "path",
            "name": "room_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoomRoleAssignmentUpdateRequest"
              }
            }
          },
          "description": "変更内容",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomRoleAssignmentUpdateResponse"
                }
              }
            },
            "description": "リクエスト後の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "未ログインユーザーのルームロールを変更",
        "tags": [
          "ルームロール"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/rooms/{room_id}/room-role-assignments/authenticated-default": {
      "get": {
        "callbacks": {},
        "description": "直接割り当てられていない場合、`role`は`null`です。\n\n必要なスコープ：`room_roles:authenticated_default:read`",
        "operationId": "getAuthenticatedDefaultRoomRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ルームID（ルームURLに含まれるID）。",
            "in": "path",
            "name": "room_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomRoleAssignmentResponse"
                }
              }
            },
            "description": "現在の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "ログインユーザーの既定ルームロールを取得",
        "tags": [
          "ルームロール"
        ]
      },
      "patch": {
        "callbacks": {},
        "description": "`roleId`に`null`を指定すると直接割当を解除します。`ifRoleId`を指定すると、現在のロールが一致する場合だけ変更します。一致しない場合はHTTP 200で`status: unchanged`、`reason: role_changed_by_other`を返し、変更しません。\n\n必要なスコープ：`room_roles:authenticated_default:write`",
        "operationId": "updateAuthenticatedDefaultRoomRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ルームID（ルームURLに含まれるID）。",
            "in": "path",
            "name": "room_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoomRoleAssignmentUpdateRequest"
              }
            }
          },
          "description": "変更内容",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomRoleAssignmentUpdateResponse"
                }
              }
            },
            "description": "リクエスト後の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "ログインユーザーの既定ルームロールを変更",
        "tags": [
          "ルームロール"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/rooms/{room_id}/room-role-assignments/groups/{group_id}": {
      "get": {
        "callbacks": {},
        "description": "直接割り当てられていない場合、`role`は`null`です。\n\n必要なスコープ：`room_roles:group:read`",
        "operationId": "getGroupRoomRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ルームID（ルームURLに含まれるID）。",
            "in": "path",
            "name": "room_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "グループID。",
            "in": "path",
            "name": "group_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomRoleAssignmentResponse"
                }
              }
            },
            "description": "現在の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "グループのルームロール割当を取得",
        "tags": [
          "ルームロール"
        ]
      },
      "patch": {
        "callbacks": {},
        "description": "`roleId`に`null`を指定すると直接割当を解除します。`ifRoleId`を指定すると、現在のロールが一致する場合だけ変更します。一致しない場合はHTTP 200で`status: unchanged`、`reason: role_changed_by_other`を返し、変更しません。\n\n必要なスコープ：`room_roles:group:write`",
        "operationId": "updateGroupRoomRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ルームID（ルームURLに含まれるID）。",
            "in": "path",
            "name": "room_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "グループID。",
            "in": "path",
            "name": "group_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoomRoleAssignmentUpdateRequest"
              }
            }
          },
          "description": "変更内容",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomRoleAssignmentUpdateResponse"
                }
              }
            },
            "description": "リクエスト後の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "グループのルームロール割当を変更",
        "tags": [
          "ルームロール"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/rooms/{room_id}/room-role-assignments/users/{user_id}": {
      "get": {
        "callbacks": {},
        "description": "直接割り当てられていない場合、`role`は`null`です。\n\n必要なスコープ：`room_roles:user:read`",
        "operationId": "getUserRoomRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ルームID（ルームURLに含まれるID）。",
            "in": "path",
            "name": "room_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ユーザーID。",
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomRoleAssignmentResponse"
                }
              }
            },
            "description": "現在の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "ユーザーのルームロール割当を取得",
        "tags": [
          "ルームロール"
        ]
      },
      "patch": {
        "callbacks": {},
        "description": "`roleId`に`null`を指定すると直接割当を解除します。`ifRoleId`を指定すると、現在のロールが一致する場合だけ変更します。一致しない場合はHTTP 200で`status: unchanged`、`reason: role_changed_by_other`を返し、変更しません。\n\n必要なスコープ：`room_roles:user:write`",
        "operationId": "updateUserRoomRoleAssignment",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ルームID（ルームURLに含まれるID）。",
            "in": "path",
            "name": "room_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ユーザーID。",
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoomRoleAssignmentUpdateRequest"
              }
            }
          },
          "description": "変更内容",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomRoleAssignmentUpdateResponse"
                }
              }
            },
            "description": "リクエスト後の割当"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "ユーザーのルームロール割当を変更",
        "tags": [
          "ルームロール"
        ]
      }
    },
    "/api/v3/organizations/{organization_id}/users/{user_id}/groups": {
      "get": {
        "callbacks": {},
        "description": "`user_id`はUUID形式で指定します。\n\n必要なスコープ：`group_memberships:read`",
        "operationId": "listUserGroups",
        "parameters": [
          {
            "description": "クライアントが所属する組織のID。",
            "in": "path",
            "name": "organization_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "ユーザーID。",
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserGroupsResponse"
                }
              }
            },
            "description": "所属グループ一覧"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "アクセストークンがない、無効、または有効期限切れです。"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "クライアントが無効か、別の組織のIDを指定したか、必要なスコープがありません。"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "組織内に、指定したルーム、ユーザー、グループ、ロールがありません。"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "リクエストが不正です。"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "レート制限を超えました。`retry-after`ヘッダーの秒数を待ってから再試行してください。"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "処理を完了できませんでした。組織ロールの変更などは反映済みの場合があるため、再送するか取得APIで現在の状態を確認してください。"
          }
        },
        "summary": "ユーザーの所属グループ一覧を取得",
        "tags": [
          "グループ所属"
        ]
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "description": "本番環境",
      "url": "https://metatell.app",
      "variables": {}
    }
  ],
  "tags": [
    {
      "name": "ルームロール"
    },
    {
      "name": "組織ロール"
    },
    {
      "name": "グループ"
    },
    {
      "name": "グループ所属"
    }
  ]
}
