kickflow 0.1.0 → 0.2.0

data/vendor/schema.yaml

@@ -4,11 +4,30 @@ info:
   version: 1.0.0
   description: kickflowの開発者用REST API (v1)
   contact:
-    name: 'kickflow, Inc.'
-    url: 'https://kickflow.com'
-  termsOfService: 'https://kickflow.com/terms'
+    name: kickflow, Inc.
+    url: https://kickflow.com
+  termsOfService: https://kickflow.com/terms
+servers:
+  - url: https://api.kickflow.com
+    description: kickflow REST API v1
+tags:
+  - name: ユーザー
+  - name: 役職
+  - name: 代理申請
+  - name: 代理承認
+  - name: 組織図
+  - name: チーム
+  - name: カテゴリ
+  - name: フォルダ
+  - name: 経路
+  - name: ワークフロー
+  - name: チケット
+  - name: ファイル
+  - name: 汎用マスタ
+  - name: 管理者ロール
+  - name: コメント
 paths:
-  /categories:
+  /v1/categories:
     get:
       summary: カテゴリの一覧を取得
       tags:
@@ -70,9 +89,9 @@ paths:
                 - name
       description: |-
         カテゴリを作成します。
-        
+
         このAPIの実行には、ワークフローの管理権限が必要です。
-  '/categories/{categoryId}':
+  /v1/categories/{categoryId}:
     parameters:
       - schema:
           type: string
@@ -90,7 +109,7 @@ paths:
       operationId: delete-categories-categoryId
       description: |-
         カテゴリを削除します。
-        
+
         このAPIの実行には、ワークフローの管理権限が必要です。
     patch:
       summary: カテゴリを更新
@@ -117,9 +136,9 @@ paths:
                 - name
       description: |-
         カテゴリを更新します。
-        
+
         このAPIの実行には、ワークフローの管理権限が必要です。
-  /folders:
+  /v1/folders:
     get:
       summary: フォルダの一覧を取得
       tags:
@@ -192,9 +211,9 @@ paths:
                 - name
       description: |-
         フォルダを作成します。
-        
+
         このAPIの実行には、ワークフローの管理権限が必要です。
-  '/folders/{folderId}':
+  /v1/folders/{folderId}:
     parameters:
       - schema:
           type: string
@@ -212,7 +231,7 @@ paths:
       operationId: delete-folders-folderId
       description: |-
         フォルダを削除します。
-        
+
         このAPIの実行には、ワークフローの管理権限が必要です。
 
         注意：このフォルダ以下のすべてのフォルダ・ワークフロー・経路・パイプラインも削除されます。
@@ -250,7 +269,7 @@ paths:
                   nullable: true
       description: |-
         フォルダを更新します。
-        
+
         このAPIの実行には、ワークフローの管理権限が必要です。
     get:
       summary: フォルダを取得
@@ -265,7 +284,7 @@ paths:
       tags:
         - フォルダ
       description: フォルダを一件取得します。
-  /generalMasters:
+  /v1/generalMasters:
     get:
       summary: 汎用マスタの一覧を取得
       tags:
@@ -303,7 +322,7 @@ paths:
           description: 'ソート。 指定可能なフィールド: createdAt, code, name'
       description: |-
         汎用マスタの一覧を取得します。
-        
+
         このAPIの実行には、汎用マスタの管理権限が必要です。
     post:
       summary: 汎用マスタを作成
@@ -380,9 +399,9 @@ paths:
                 - name
       description: |-
         汎用マスタを作成します。
-        
+
         このAPIの実行には、汎用マスタの管理権限が必要です。
-  '/generalMasters/{generalMasterId}':
+  /v1/generalMasters/{generalMasterId}:
     parameters:
       - schema:
           type: string
@@ -404,7 +423,7 @@ paths:
       operationId: get-generalMasters-generalMasterId
       description: |-
         汎用マスタを一件取得します。
-        
+
         このAPIの実行には、汎用マスタの管理権限が必要です。
     patch:
       summary: 汎用マスタを更新
@@ -468,7 +487,7 @@ paths:
                       - code
       description: |-
         汎用マスタを更新します。
-        
+
         このAPIの実行には、汎用マスタの管理権限が必要です。
     delete:
       summary: 汎用マスタを削除
@@ -480,9 +499,9 @@ paths:
       operationId: delete-generalMasters-generalMasterId
       description: |-
         汎用マスタを削除します。この汎用マスタのすべてのアイテムも同時に削除されます。
-        
+
         このAPIの実行には、汎用マスタの管理権限が必要です。
-  '/generalMasters/{generalMasterId}/items':
+  /v1/generalMasters/{generalMasterId}/items:
     parameters:
       - schema:
           type: string
@@ -589,9 +608,9 @@ paths:
         description: ''
       description: |-
         汎用マスタアイテムを作成します。
-        
+
         このAPIの実行には、汎用マスタの管理権限が必要です。
-  '/generalMasters/{generalMasterId}/items/{itemId}':
+  /v1/generalMasters/{generalMasterId}/items/{itemId}:
     parameters:
       - schema:
           type: string
@@ -677,7 +696,7 @@ paths:
                       - value
       description: |-
         汎用マスタアイテムを更新します。
-        
+
         このAPIの実行には、汎用マスタの管理権限が必要です。
     delete:
       summary: 汎用マスタアイテムを削除
@@ -689,9 +708,9 @@ paths:
       operationId: delete-generalMasters-generalMasterId-items-itemId
       description: |-
         汎用マスタアイテムを削除します。
-        
+
         このAPIの実行には、汎用マスタの管理権限が必要です。
-  /grades:
+  /v1/grades:
     get:
       summary: 役職の一覧を取得
       tags:
@@ -729,7 +748,7 @@ paths:
           description: 'ソート。指定可能なフィールド: level, code'
       description: |-
         役職の一覧を取得します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
     post:
       summary: 役職を作成
@@ -750,9 +769,9 @@ paths:
               $ref: '#/components/schemas/gradeCreateBody'
       description: |-
         役職を作成します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
-  '/grades/{gradeId}':
+  /v1/grades/{gradeId}:
     parameters:
       - schema:
           type: string
@@ -774,7 +793,7 @@ paths:
       operationId: get-grades-gradeId
       description: |-
         役職を一件取得します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
     delete:
       summary: 役職を削除
@@ -786,7 +805,7 @@ paths:
       operationId: delete-grades-gradeId
       description: |-
         役職を削除します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
 
         注意：この役職を使用しているユーザーがいる場合、エラーとなります。先にユーザーから対象の役職を外してください。
@@ -809,9 +828,9 @@ paths:
               $ref: '#/components/schemas/gradeUpdateBody'
       description: |-
         役職を更新します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
-  '/grades/{gradeId}/default':
+  /v1/grades/{gradeId}/default:
     parameters:
       - schema:
           type: string
@@ -828,11 +847,11 @@ paths:
       description: |-
         指定した役職をデフォルトにします。
         同時に、これまでデフォルトだった役職は自動的にデフォルトではなくなります。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
       tags:
         - 役職
-  /organizationCharts:
+  /v1/organizationCharts:
     get:
       summary: 組織図の一覧を取得
       tags:
@@ -870,7 +889,7 @@ paths:
           description: 'ソート。指定可能なフィールド: createdAt, name'
       description: |-
         組織図の一覧を取得します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
 
         注意：パフォーマンス上の理由から、組織図の一覧取得時は組織図内のチームのリストがレスポンスに含まれません。
@@ -894,9 +913,9 @@ paths:
               $ref: '#/components/schemas/organizationChartBody'
       description: |-
         組織図を作成します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
-  '/organizationCharts/{organizationChartId}':
+  /v1/organizationCharts/{organizationChartId}:
     parameters:
       - schema:
           type: string
@@ -914,7 +933,7 @@ paths:
       operationId: delete-organizationCharts-organizationChartId
       description: |-
         組織図を削除します。同時に、組織図内のチームや所属もすべて削除されます。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
 
         注意：現在有効な組織図は削除できません。
@@ -933,7 +952,7 @@ paths:
         - 組織図
       description: |-
         組織図を一件取得します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
     patch:
       summary: 組織図を更新
@@ -954,9 +973,9 @@ paths:
               $ref: '#/components/schemas/organizationChartBody'
       description: |-
         組織図を更新します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
-  /organizationChart:
+  /v1/organizationChart:
     get:
       summary: 現在の組織図を取得
       tags:
@@ -971,9 +990,9 @@ paths:
       operationId: get-organizationChart
       description: |-
         現在有効になっている組織図を取得します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
-  '/organizationCharts/{organizationChartId}/activate':
+  /v1/organizationCharts/{organizationChartId}/activate:
     parameters:
       - schema:
           type: string
@@ -996,7 +1015,7 @@ paths:
       description: |-
         指定した組織図を有効化し、ワークフローで使用する組織図を切り替えます。
         他の組織図に有効化の予定がある場合、それらの予定は削除されます。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
 
         注意：組織図の有効化は時間がかかることがあるため、有効化は非同期で実行されます。有効化の完了前にレスポンスを返すので注意してください。
@@ -1010,7 +1029,7 @@ paths:
                   type: string
                   format: date
                   description: 有効化する日付。nullの場合、即時で有効化します。
-  '/organizationCharts/{organizationChartId}/teams':
+  /v1/organizationCharts/{organizationChartId}/teams:
     parameters:
       - schema:
           type: string
@@ -1032,9 +1051,9 @@ paths:
                   $ref: '#/components/schemas/team'
       description: |-
         指定した組織図内のチーム一覧を取得します。
-        
+
         parentIdを指定した場合は指定した親チームの配下チームの一覧を、parentIdを指定しない場合は組織図内のルートのチーム一覧を返します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
       parameters:
         - schema:
@@ -1073,14 +1092,14 @@ paths:
       operationId: post-organizationCharts-organizationChartId-teams
       description: |-
         指定した組織図内にチームを作成します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
       requestBody:
         content:
           application/json:
             schema:
               $ref: '#/components/schemas/teamCreateBody'
-  '/organizationCharts/{organizationChartId}/teams/{teamId}':
+  /v1/organizationCharts/{organizationChartId}/teams/{teamId}:
     parameters:
       - schema:
           type: string
@@ -1108,7 +1127,7 @@ paths:
       operationId: get-teams-teamId
       description: |-
         チームを一件取得します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
     patch:
       summary: チームを編集
@@ -1129,7 +1148,7 @@ paths:
               $ref: '#/components/schemas/teamUpdateBody'
       description: |-
         チームを更新します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
     delete:
       summary: チームを削除
@@ -1141,9 +1160,9 @@ paths:
       operationId: delete-teams-teamId
       description: |-
         チームを削除します。同時に、このチームの所属もすべて削除されます。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
-  '/organizationCharts/{organizationChartId}/teams/{teamId}/memberships':
+  /v1/organizationCharts/{organizationChartId}/teams/{teamId}/memberships:
     parameters:
       - schema:
           type: string
@@ -1171,7 +1190,7 @@ paths:
                   $ref: '#/components/schemas/memberUser'
       description: |-
         チームのメンバー一覧を取得します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
       parameters:
         - schema:
@@ -1201,7 +1220,7 @@ paths:
       operationId: post-teams-teamId-members
       description: |-
         指定したチームにメンバーを追加します。最大10人まで同時に追加可能です。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
 
         注意: チームにリーダーは最低一人必要です。リーダーが不在の場合、APIは422 Unprocessable Entityを返します。
@@ -1249,7 +1268,7 @@ paths:
         - チーム
       description: |-
         指定したチームからメンバーを削除します。最大10人まで同時に削除可能です。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
 
         注意: 削除後もメンバーが残る場合、チームにリーダーは最低一人必要です。メンバー削除によってリーダーが不在になる場合、APIは422 Unprocessable Entityを返します。
@@ -1270,7 +1289,7 @@ paths:
                     format: uuid
               required:
                 - userIds
-  '/organizationCharts/{organizationChartId}/teams/{teamId}/memberships/{userId}':
+  /v1/organizationCharts/{organizationChartId}/teams/{teamId}/memberships/{userId}:
     parameters:
       - schema:
           type: string
@@ -1300,7 +1319,7 @@ paths:
         - チーム
       description: |-
         指定したメンバーを更新します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
 
         注意: チームにリーダーは最低一人は必要です。リーダーが不在の場合、APIは422 Unprocessable Entityを返します。
@@ -1323,7 +1342,7 @@ paths:
               required:
                 - leader
                 - gradeIds
-  /roles:
+  /v1/roles:
     get:
       summary: 管理者ロールの一覧を取得
       tags:
@@ -1361,7 +1380,7 @@ paths:
           description: 'ソート。 指定可能なフィールド: createdAt, name'
       description: |-
         管理者ロールの一覧を取得します。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
     post:
       summary: 管理者ロールを作成
@@ -1382,9 +1401,9 @@ paths:
               $ref: '#/components/schemas/roleCreateBody'
       description: |-
         管理者ロールを作成します。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
-  '/roles/{roleId}':
+  /v1/roles/{roleId}:
     parameters:
       - schema:
           type: string
@@ -1406,7 +1425,7 @@ paths:
       operationId: get-roles-roleId
       description: |-
         管理者ロールを一件取得します。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
     patch:
       summary: 管理者ロールを更新
@@ -1427,7 +1446,7 @@ paths:
               $ref: '#/components/schemas/roleUpdateBody'
       description: |-
         管理者ロールを更新します。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
     delete:
       summary: 管理者ロールを削除
@@ -1439,9 +1458,9 @@ paths:
       operationId: delete-roles-roleId
       description: |-
         管理者ロールを削除します。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
-  '/roles/{roleId}/memberships':
+  /v1/roles/{roleId}/memberships:
     parameters:
       - schema:
           type: string
@@ -1476,7 +1495,7 @@ paths:
                 - userIds
       description: |-
         管理者ロールにメンバーを追加します。最大10人まで複数のメンバーを同時に追加可能です。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
     get:
       summary: 管理者ロールのメンバー一覧を取得
@@ -1510,9 +1529,9 @@ paths:
         - 管理者ロール
       description: |-
         管理者ロールのメンバー一覧を取得します。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
-  '/roles/{roleId}/memberships/{userId}':
+  /v1/roles/{roleId}/memberships/{userId}:
     parameters:
       - schema:
           type: string
@@ -1536,9 +1555,9 @@ paths:
       operationId: delete-roles-roleId-memberships-userId
       description: |-
         管理者ロールからメンバーを削除します。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
-  /tickets:
+  /v1/tickets:
     get:
       summary: チケット一覧を取得
       tags:
@@ -1551,7 +1570,7 @@ paths:
               schema:
                 type: array
                 items:
-                  $ref: '#/components/schemas/ticket'
+                  $ref: '#/components/schemas/ticketWithStep'
       operationId: get-tickets
       description: |-
         チケットの一覧を取得します。複数の条件を組み合わせて、フィルタ可能です。
@@ -1730,6 +1749,11 @@ paths:
           in: query
           name: assigneeStatus
           description: 承認者の状態。assigneeUserIdとセットで指定してください。
+        - schema:
+            type: string
+          in: query
+          name: stepTitle
+          description: 現在の承認ステップ名
     post:
       summary: チケットを作成
       operationId: post-tickets
@@ -1813,10 +1837,40 @@ paths:
                                   items:
                                     type: string
                                     format: uuid
+                            userId:
+                              description: ユーザーUUID。フィールドがユーザータイプのときのみ指定してください。
+                              oneOf:
+                                - type: string
+                                  format: uuid
+                                  nullable: true
+                                - type: array
+                                  items:
+                                    type: string
+                                    format: uuid
+                            teamId:
+                              description: チームUUID。フィールドがチームタイプのときのみ指定してください。
+                              oneOf:
+                                - type: string
+                                  format: uuid
+                                  nullable: true
+                                - type: array
+                                  items:
+                                    type: string
+                                    format: uuid
+                            ticketId:
+                              description: チケットUUID。フィールドがチケットタイプのときのみ指定してください。
+                              oneOf:
+                                - type: string
+                                  format: uuid
+                                  nullable: true
+                                - type: array
+                                  items:
+                                    type: string
+                                    format: uuid
                             files:
                               type: array
                               description: |-
-                                添付ファイルの署名入りID。
+                                添付ファイルの署名済みID。
                                 フィールドがファイルタイプのときのみ指定してください。
                               nullable: true
                               items:
@@ -1890,7 +1944,7 @@ paths:
                       files:
                         type: array
                         description: |-
-                          添付ファイルの署名入りID。
+                          添付ファイルの署名済みID。
                           フィールドがファイルタイプのときのみ指定してください。
                         nullable: true
                         items:
@@ -1917,7 +1971,7 @@ paths:
                 - workflowId
                 - authorTeamId
                 - inputs
-  /tickets/tasks:
+  /v1/tickets/tasks:
     get:
       summary: 承認リクエスト一覧を取得
       tags:
@@ -1930,7 +1984,7 @@ paths:
               schema:
                 type: array
                 items:
-                  $ref: '#/components/schemas/ticket'
+                  $ref: '#/components/schemas/ticketWithStep'
       operationId: get-tickets-tasks
       description: |-
         現在のユーザーにアサインされている承認リクエストの一覧を取得します。複数の条件を組み合わせて、フィルタ可能です。
@@ -2059,7 +2113,12 @@ paths:
           in: query
           name: deletedAtEnd
           description: 削除日時の終点
-  '/tickets/{ticketId}':
+        - schema:
+            type: string
+          in: query
+          name: stepTitle
+          description: 現在の承認ステップ名
+  /v1/tickets/{ticketId}:
     parameters:
       - schema:
           type: string
@@ -2113,7 +2172,7 @@ paths:
                     - draft
                     - in_progress
                     - rejected
-                  description: 'ステータス。更新ではdraft, in_progress, rejectedのみ選択可能です。'
+                  description: ステータス。更新ではdraft, in_progress, rejectedのみ選択可能です。
                 authorTeamId:
                   type: string
                   description: 申請者チームのUUID
@@ -2156,13 +2215,49 @@ paths:
                                   items:
                                     type: string
                             generalMasterItemId:
-                              type: string
                               description: 汎用マスタアイテムのUUID。フィールドが汎用マスタタイプのときのみ指定してください。
-                              nullable: true
+                              oneOf:
+                                - type: string
+                                  format: uuid
+                                  nullable: true
+                                - type: array
+                                  items:
+                                    type: string
+                                    format: uuid
+                            userId:
+                              description: ユーザーUUID。フィールドがユーザータイプのときのみ指定してください。
+                              oneOf:
+                                - type: string
+                                  format: uuid
+                                  nullable: true
+                                - type: array
+                                  items:
+                                    type: string
+                                    format: uuid
+                            teamId:
+                              description: チームUUID。フィールドがチームタイプのときのみ指定してください。
+                              oneOf:
+                                - type: string
+                                  format: uuid
+                                  nullable: true
+                                - type: array
+                                  items:
+                                    type: string
+                                    format: uuid
+                            ticketId:
+                              description: チケットUUID。フィールドがチケットタイプのときのみ指定してください。
+                              oneOf:
+                                - type: string
+                                  format: uuid
+                                  nullable: true
+                                - type: array
+                                  items:
+                                    type: string
+                                    format: uuid
                             files:
                               type: array
                               description: |-
-                                添付ファイルの署名入りID。
+                                添付ファイルの署名済みID。
                                 フィールドがファイルタイプのときのみ指定してください。
                               nullable: true
                               items:
@@ -2240,7 +2335,7 @@ paths:
                       files:
                         type: array
                         description: |-
-                          添付ファイルの署名入りID。
+                          添付ファイルの署名済みID。
                           フィールドがファイルタイプのときのみ指定してください。
                         nullable: true
                         items:
@@ -2262,7 +2357,7 @@ paths:
                     - id
                     - title
                     - sandbox
-  '/tickets/{ticketId}/approve':
+  /v1/tickets/{ticketId}/approve:
     parameters:
       - schema:
           type: string
@@ -2272,7 +2367,7 @@ paths:
         required: true
         description: チケットのUUID
     post:
-      summary: チケットを承認する
+      summary: チケットを承認または確認する
       tags:
         - チケット
       responses:
@@ -2284,9 +2379,9 @@ paths:
                 $ref: '#/components/schemas/ticketDetail'
       operationId: post-tickets-ticketId-approve
       description: |-
-        指定したチケットを承認します。
+        指定したチケットを承認もしくは確認します。
         APIの実行ユーザーがチケットにアサインされていない場合、403 Forbiddenを返します。
-  '/tickets/{ticketId}/reject':
+  /v1/tickets/{ticketId}/reject:
     parameters:
       - schema:
           type: string
@@ -2321,7 +2416,7 @@ paths:
       description: |-
         指定したチケットを差し戻します。
         APIの実行ユーザーがチケットにアサインされていない場合、403 Forbiddenを返します。
-  '/tickets/{ticketId}/deny':
+  /v1/tickets/{ticketId}/deny:
     parameters:
       - schema:
           type: string
@@ -2350,7 +2445,7 @@ paths:
       description: |-
         指定したチケットを却下します。
         APIの実行ユーザーがチケットにアサインされていない場合、403 Forbiddenを返します。
-  '/tickets/{ticketId}/withdraw':
+  /v1/tickets/{ticketId}/withdraw:
     parameters:
       - schema:
           type: string
@@ -2372,7 +2467,7 @@ paths:
                 $ref: '#/components/schemas/ticketDetail'
       operationId: post-tickets-ticketId-withdraw
       description: 自分が作成したチケットを取り下げます。
-  '/tickets/{ticketId}/archive':
+  /v1/tickets/{ticketId}/archive:
     parameters:
       - schema:
           type: string
@@ -2397,7 +2492,7 @@ paths:
         チケットをアーカイブします。チケットのステータスがアーカイブステータスに変わりますが、引き続きUIやAPIでチケットにはアクセス可能です。
 
         注意：チケットをアーカイブ可能なユーザーはチケットのステータスによって異なります。詳しくは[ヘルプ](https://support.kickflow.com/hc/ja/articles/360058324973)をご覧ください。
-  '/tickets/{ticketId}/links':
+  /v1/tickets/{ticketId}/links:
     parameters:
       - schema:
           type: string
@@ -2437,7 +2532,7 @@ paths:
           in: query
           name: perPage
           description: 1ページあたりの件数
-  '/tickets/{ticketId}/viewers':
+  /v1/tickets/{ticketId}/viewers:
     parameters:
       - schema:
           type: string
@@ -2522,7 +2617,7 @@ paths:
                   format: uuid
                   description: 役職のUUID。teamId指定時のみ、任意で指定できます。
                   nullable: true
-  '/tickets/{ticketId}/viewers/{viewerId}':
+  /v1/tickets/{ticketId}/viewers/{viewerId}:
     parameters:
       - schema:
           type: string
@@ -2547,7 +2642,7 @@ paths:
           description: OK
       operationId: delete-tickets-id-viewers-viewerId
       description: チケットの閲覧者を削除します。
-  '/tickets/{ticketId}/comments':
+  /v1/tickets/{ticketId}/comments:
     parameters:
       - schema:
           type: string
@@ -2616,13 +2711,13 @@ paths:
                   description: 本文
                 files:
                   type: array
-                  description: 添付ファイルの署名入りID
+                  description: 添付ファイルの署名済みID
                   nullable: true
                   items:
                     type: string
               required:
                 - body
-  '/tickets/{ticketId}/comments/{commentId}':
+  /v1/tickets/{ticketId}/comments/{commentId}:
     parameters:
       - schema:
           type: string
@@ -2684,7 +2779,7 @@ paths:
           description: OK
       operationId: delete-tickets-id-comments-commentId
       description: チケットのコメントを削除します。
-  /user:
+  /v1/user:
     get:
       summary: 現在のユーザーを取得
       tags:
@@ -2698,7 +2793,7 @@ paths:
                 $ref: '#/components/schemas/userDetail'
       operationId: get-user
       description: 現在のユーザーを取得します。
-  /users:
+  /v1/users:
     get:
       summary: ユーザー一覧を取得
       tags:
@@ -2767,7 +2862,7 @@ paths:
       description: |-
         ユーザーを作成します。
         作成されたユーザーは招待済みステータスとなり、招待メールが送信されます。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
       requestBody:
         content:
@@ -2806,7 +2901,7 @@ paths:
                 - lastName
       tags:
         - ユーザー
-  '/users/{userId}':
+  /v1/users/{userId}:
     parameters:
       - schema:
           type: string
@@ -2837,12 +2932,12 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/user'
+                $ref: '#/components/schemas/userDetail'
       operationId: delete-users-userId
       description: |-
         ユーザーを削除します（論理削除）。
         削除されたユーザーは削除済ステータスとなりますが、引き続きユーザー情報にアクセス可能です。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
     patch:
       summary: ユーザーを更新
@@ -2886,9 +2981,9 @@ paths:
         - ユーザー
       description: |-
         ユーザーを更新します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
-  /users/lookupByEmail:
+  /v1/users/lookupByEmail:
     get:
       summary: メールアドレスからユーザーを取得
       tags:
@@ -2911,7 +3006,7 @@ paths:
       description: |-
         メールアドレスからユーザーを取得します（完全一致）
         ※メールアドレスはURLエンコードしたものを送ってください。
-  '/users/{userId}/reinvite':
+  /v1/users/{userId}/reinvite:
     parameters:
       - schema:
           type: string
@@ -2931,11 +3026,11 @@ paths:
       operationId: post-users-userId-reinvite
       description: |-
         削除されたユーザーを再び招待します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
       tags:
         - ユーザー
-  '/users/{userId}/suspend':
+  /v1/users/{userId}/suspend:
     parameters:
       - schema:
           type: string
@@ -2955,11 +3050,11 @@ paths:
       operationId: post-users-userId-suspend
       description: |-
         有効なユーザーを一時停止します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
       tags:
         - ユーザー
-  '/users/{userId}/reactivate':
+  /v1/users/{userId}/reactivate:
     parameters:
       - schema:
           type: string
@@ -2979,11 +3074,11 @@ paths:
       operationId: post-users-userId-reactivate
       description: |-
         一時停止中のユーザーを有効化します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
       tags:
         - ユーザー
-  '/users/{userId}/teams':
+  /v1/users/{userId}/teams:
     parameters:
       - schema:
           type: string
@@ -3007,7 +3102,7 @@ paths:
         - ユーザー
       description: |-
         ユーザーの所属チーム一覧を取得します。
-        
+
         このAPIの実行には、チームの管理権限が必要です。
       parameters:
         - schema:
@@ -3030,7 +3125,7 @@ paths:
           in: query
           name: submittable
           description: trueの場合、申請可能なチームのみ返す。デフォルトはfalse（すべてのチームを返す）
-  '/users/{userId}/roles':
+  /v1/users/{userId}/roles:
     parameters:
       - schema:
           type: string
@@ -3054,7 +3149,7 @@ paths:
         - ユーザー
       description: |-
         ユーザーの管理者ロール一覧を取得します。
-        
+
         このAPIの実行には、ロールの管理権限が必要です。
       parameters:
         - schema:
@@ -3072,7 +3167,7 @@ paths:
           in: query
           name: perPage
           description: 1ページあたりの件数
-  /routes:
+  /v1/routes:
     get:
       summary: 経路一覧を取得
       tags:
@@ -3089,7 +3184,7 @@ paths:
       operationId: get-routes
       description: |-
         経路の一覧を取得します。ステータスやフォルダによる絞り込みが可能です。
-        
+
         このAPIの実行には、ワークフローの管理権限が必要です。
       parameters:
         - schema:
@@ -3128,7 +3223,7 @@ paths:
           in: query
           name: folderId
           description: フォルダのUUID
-  '/routes/{routeId}':
+  /v1/routes/{routeId}:
     parameters:
       - schema:
           type: string
@@ -3150,9 +3245,9 @@ paths:
       operationId: get-routes-routeId
       description: |-
         指定した経路を取得します。
-        
+
         このAPIの実行には、ワークフローの管理権限が必要です。
-  /workflows:
+  /v1/workflows:
     get:
       summary: ワークフロー一覧を取得
       tags:
@@ -3199,7 +3294,7 @@ paths:
           name: status
           description: ステータス
       description: ワークフローの一覧を取得します。ステータスによる絞り込みが可能です。
-  '/workflows/{workflowId}':
+  /v1/workflows/{workflowId}:
     parameters:
       - schema:
           type: string
@@ -3220,7 +3315,7 @@ paths:
                 $ref: '#/components/schemas/workflowDetail'
       operationId: get-workflows-workflowId
       description: 指定したIDのワークフローを取得します。
-  /proxyApplicants:
+  /v1/proxyApplicants:
     get:
       summary: 代理申請一覧を取得
       tags:
@@ -3253,7 +3348,7 @@ paths:
       operationId: get-proxyApplicants
       description: |-
         テナント内の代理申請の一覧を取得します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
     post:
       summary: 代理申請を作成
@@ -3302,9 +3397,9 @@ paths:
                 - proxyUserId
       description: |-
         代理申請を新規作成します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。ただし、自分の代理申請の設定をすべてのユーザーに許可している場合、管理権限は不要です。
-  '/proxyApplicants/{proxyApplicantId}':
+  /v1/proxyApplicants/{proxyApplicantId}:
     parameters:
       - schema:
           type: string
@@ -3323,9 +3418,9 @@ paths:
       operationId: delete-proxyApplicants-proxyApplicantId
       description: |-
         指定した代理申請を削除します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。ただし、自分の代理申請の設定をすべてのユーザーに許可している場合、管理権限は不要です。
-  /proxyApprovers:
+  /v1/proxyApprovers:
     get:
       summary: 代理承認一覧を取得
       tags:
@@ -3358,7 +3453,7 @@ paths:
       operationId: get-proxyApprovers
       description: |-
         テナント内の代理承認の一覧を取得します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。
     post:
       summary: 代理承認を作成
@@ -3374,7 +3469,7 @@ paths:
       operationId: post-proxyApprovers
       description: |-
         代理承認を新規作成します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。ただし、自分の代理承認の設定をすべてのユーザーに許可している場合、管理権限は不要です。
       requestBody:
         content:
@@ -3409,7 +3504,7 @@ paths:
               required:
                 - userId
                 - proxyUserId
-  '/proxyApprovers/{proxyApproverId}':
+  /v1/proxyApprovers/{proxyApproverId}:
     parameters:
       - schema:
           type: string
@@ -3428,9 +3523,9 @@ paths:
       operationId: delete-proxyApprovers-proxyApproverId
       description: |-
         指定した代理承認を削除します。
-        
+
         このAPIの実行には、ユーザーの管理権限が必要です。ただし、自分の代理承認の設定をすべてのユーザーに許可している場合、管理権限は不要です。
-  /files:
+  /v1/files:
     post:
       summary: 添付ファイルをアップロード
       tags:
@@ -3445,12 +3540,12 @@ paths:
                 properties:
                   signedId:
                     type: string
-                    description: 添付ファイルの署名入りID
+                    description: 添付ファイルの署名済みID
                 required:
                   - signedId
       operationId: post-files
       description: |-
-        添付ファイルをアップロードします。
+        添付ファイルをアップロードします。最大2MBまでのファイルをアップロード可能です。
 
         注意：このAPIはエンタープライズプランのお客様のみ利用可能です。
 
@@ -3464,14 +3559,14 @@ paths:
                 file:
                   description: 添付ファイル
         description: ''
-  '/files/{signedId}':
+  /v1/files/{signedId}:
     parameters:
       - schema:
           type: string
         name: signedId
         in: path
         required: true
-        description: 添付ファイルの署名入りID
+        description: 添付ファイルの署名済みID
     get:
       summary: 添付ファイルの情報を取得
       responses:
@@ -3649,9 +3744,18 @@ components:
           description: ユーザー画像のURL。サイズごとに複数のURLを返します。
           required:
             - 100x100
+            - 64x64
+            - 32x32
           properties:
             100x100:
               type: string
+              nullable: true
+            64x64:
+              type: string
+              nullable: true
+            32x32:
+              type: string
+              nullable: true
         status:
           type: string
           enum:
@@ -4082,6 +4186,8 @@ components:
                       - master
                       - ticket_read
                       - ticket_write
+                      - label
+                      - automation
                     description: 権限タイプ
                   restricted:
                     type: boolean
@@ -4137,11 +4243,14 @@ components:
                   - audit
                   - stats
                   - workflow
-                  - ticket
                   - user
                   - team
                   - role
                   - master
+                  - ticket_read
+                  - ticket_write
+                  - label
+                  - automation
               restricted:
                 type: boolean
                 description: 管理対象を制限する場合true
@@ -4196,11 +4305,14 @@ components:
                   - audit
                   - stats
                   - workflow
-                  - ticket
                   - user
                   - team
                   - role
                   - master
+                  - ticket_read
+                  - ticket_write
+                  - label
+                  - automation
               restricted:
                 type: boolean
                 description: 管理対象を制限する場合true
@@ -4534,7 +4646,7 @@ components:
         code:
           type: string
           description: コード
-          pattern: '^[a-zA-Z0-9_-]+$'
+          pattern: ^[a-zA-Z0-9_-]+$
         versionId:
           type: string
           description: バージョンのUUID
@@ -4575,22 +4687,26 @@ components:
           nullable: true
         slip:
           type: boolean
-          description: 明細を持つ場合true
+          description: 明細を持つ場合true。このフィールドは廃止予定です。代わりにsectionListのsectionTypeを参照してください。
           default: false
+          deprecated: true
         slipTitle:
           type: string
-          description: 明細タイトル
+          description: 明細タイトル。このフィールドは廃止予定です。代わりにsectionListのtitleを参照してください。
           nullable: true
+          deprecated: true
         slipDescription:
           type: string
-          description: 明細の説明
+          description: 明細の説明。このフィールドは廃止予定です。代わりにsectionListのdescriptionを参照してください。
           nullable: true
+          deprecated: true
         slipPosition:
           type: string
-          description: 明細の位置
+          description: 明細の位置。このフィールドは廃止予定です。代わりにsectionListを参照してください。
           enum:
             - top
             - bottom
+          deprecated: true
         ticketNumberFormat:
           type: string
           description: チケット番号のフォーマット
@@ -4615,6 +4731,10 @@ components:
           type: string
           description: タイトルの計算式
           nullable: true
+        allowEditingOfViewers:
+          type: boolean
+          description: 閲覧者の編集が可能な場合true
+          default: true
         author:
           anyOf:
             - $ref: '#/components/schemas/user'
@@ -4671,16 +4791,23 @@ components:
         - $ref: '#/components/schemas/workflow'
         - type: object
           properties:
+            sectionList:
+              type: array
+              description: セクション・明細を表すオブジェクトを画面に表示される順に格納した配列。
+              items:
+                $ref: '#/components/schemas/sectionListItem'
             sections:
               type: array
-              description: セクションの配列
+              description: セクションの配列。このフィールドは廃止予定です。代わりにsectionListを参照してください。
               items:
                 $ref: '#/components/schemas/section'
+              deprecated: true
             slipFields:
               type: array
-              description: 明細フィールドの配列
+              description: 明細フィールドの配列。このフィールドは廃止予定です。代わりにsectionListを参照してください。
               items:
                 $ref: '#/components/schemas/slipFieldDetail'
+              deprecated: true
             ticketViewers:
               type: array
               description: ワークフロー単位のチケット閲覧者
@@ -4735,6 +4862,10 @@ components:
           type: string
           format: uuid
           description: UUID
+        sectionType:
+          type: string
+          enum:
+            - form
         title:
           type: string
           description: タイトル
@@ -4764,6 +4895,7 @@ components:
           description: 条件をすべて満たす必要があるかどうか
       required:
         - id
+        - sectionType
         - title
         - description
         - formFields
@@ -4771,6 +4903,50 @@ components:
         - updatedAt
         - conditional
         - conditionAllOf
+    sectionListItem:
+      title: SectionListItem
+      type: object
+      x-tags:
+        - workflows
+      description: 明細セクションまたはフォームセクション
+      properties:
+        sectionType:
+          type: string
+          enum:
+            - form
+            - slip
+        title:
+          type: string
+          description: タイトル
+          nullable: true
+        description:
+          type: string
+          description: 説明
+          nullable: true
+        id:
+          type: string
+          format: uuid
+          description: フォームセクションのID（UUID）。明細セクションには含まれません。
+        formFields:
+          type: array
+          description: フォームフィールド。明細セクションには含まれません。
+          items:
+            $ref: '#/components/schemas/formFieldDetail'
+        conditional:
+          type: boolean
+          description: 表示条件があるかどうか。明細セクションには含まれません。
+        conditionAllOf:
+          type: boolean
+          description: 条件をすべて満たす必要があるかどうか。明細セクションには含まれません。
+        slipFields:
+          type: array
+          description: 明細フィールド。フォームセクションには含まれません。
+          items:
+            $ref: '#/components/schemas/slipFieldDetail'
+      required:
+        - sectionType
+        - title
+        - description
     formField:
       title: FormField
       type: object
@@ -4888,6 +5064,12 @@ components:
           type: boolean
           description: 隠しフィールドである場合true
           nullable: true
+        readonlyOnUi:
+          type: boolean
+          description: |-
+            trueの時、申請者・承認者が画面上から値を入力することを禁止します。
+            ボタン（外部API連携）による代入や、REST API経由での入力はこのオプションの対象外です。
+          nullable: true
       required:
         - id
         - title
@@ -5081,6 +5263,9 @@ components:
             - date
             - file
             - master
+            - user
+            - team
+            - ticket
         code:
           type: string
           description: フィールドのコード
@@ -5151,6 +5336,12 @@ components:
           type: boolean
           description: 隠しフィールドである場合true
           nullable: true
+        readonlyOnUi:
+          type: boolean
+          description: |-
+            trueの時、申請者・承認者が画面上から値を入力することを禁止します。
+            ボタン（外部API連携）による代入や、REST API経由での入力はこのオプションの対象外です。
+          nullable: true
       required:
         - id
         - fieldType
@@ -5468,6 +5659,9 @@ components:
           anyOf:
             - $ref: '#/components/schemas/routeStepCondition'
             - nullable: true
+        code:
+          type: string
+          description: コード
       required:
         - id
         - stepOrder
@@ -5481,13 +5675,13 @@ components:
         - allowSelfApproval
         - minCustomAssignees
         - users
+        - code
     routeStepTarget:
       title: RouteStepTarget
       type: object
       properties:
         team:
           $ref: '#/components/schemas/team'
-          description: 承認者の指定に使うチーム
         descendants:
           type: boolean
           description: 'stepType=author_customizableまたはstepType=assignee_customizableの場合に、指定したチームの下位チームのメンバーも承認者候補に含めるかどうか（true: 含める、false: 含めない）'
@@ -5524,7 +5718,7 @@ components:
         routeStepConditionFields:
           anyOf:
             - $ref: '#/components/schemas/routeStepConditionField'
-            - properties: { }
+            - properties: {}
     routeStepConditionField:
       title: RouteStepConditionField
       type: object
@@ -5543,6 +5737,14 @@ components:
         fieldKey:
           type: string
           description: 変数のフィールド
+          enum:
+            - author_grade
+            - author_team
+            - text_variable
+            - number_variable
+            - checkbox_variable
+            - general_master_variable
+            - other_variable
         symbol:
           type: string
           description: 演算子
@@ -5669,6 +5871,18 @@ components:
         - forcedPublicType
         - workflow
         - labels
+    ticketWithStep:
+      allOf:
+        - $ref: '#/components/schemas/ticket'
+        - type: object
+          properties:
+            steps:
+              type: array
+              description: ステップの配列
+              items:
+                $ref: '#/components/schemas/ticketStep'
+          required:
+            - steps
     ticketDetail:
       title: TicketDetail
       x-tags:
@@ -6062,6 +6276,21 @@ components:
           description: '入力値: 汎用マスタアイテム'
           items:
             $ref: '#/components/schemas/generalMasterItem'
+        users:
+          type: array
+          description: '入力値: ユーザー'
+          items:
+            $ref: '#/components/schemas/user'
+        teams:
+          type: array
+          description: '入力値: チーム'
+          items:
+            $ref: '#/components/schemas/team'
+        inputTickets:
+          type: array
+          description: '入力値: チケット'
+          items:
+            $ref: '#/components/schemas/ticket'
         attachments:
           type: array
           description: 添付ファイル
@@ -6096,7 +6325,7 @@ components:
         color:
           type: string
           description: 'ラベルの色。#なしHEXコード（例: ff0000）'
-          pattern: '^[a-f0-9]{6}$'
+          pattern: ^[a-f0-9]{6}$
           minLength: 6
           maxLength: 6
         createdAt:
@@ -6147,7 +6376,7 @@ components:
         - id
         - code
         - name
-        - description
+        - notes
         - createdAt
         - updatedAt
     ticketViewer:
@@ -6237,22 +6466,3 @@ components:
       type: http
       scheme: bearer
       description: Personal Access Token or Service Account Token
-servers:
-  - url: 'https://api.kickflow.com/v1'
-    description: kickflow REST API v1
-tags:
-  - name: ユーザー
-  - name: 役職
-  - name: 代理申請
-  - name: 代理承認
-  - name: 組織図
-  - name: チーム
-  - name: カテゴリ
-  - name: フォルダ
-  - name: 経路
-  - name: ワークフロー
-  - name: チケット
-  - name: ファイル
-  - name: 汎用マスタ
-  - name: 管理者ロール
-  - name: コメント