工程API

工程のステータス・担当・日程を更新するAPIエンドポイントです。 コメントの投稿とリテイクの起票はアプリの画面から行います(APIでは提供していません)。

PATCH /api/v1/processes/[id]

工程のステータス・担当・日程を更新します。

リクエスト

{
  "status": "COMPLETED",       // 任意
  "statusKey": "checking",     // 任意(進行ステータスの表示層キー)
  "assigneeId": "clxxx...",    // 任意
  "startDate": "2026-01-10",   // 任意
  "dueDate": "2026-01-20"      // 任意
}

レスポンス

{
  "data": {
    "id": "clxxx...",
    "type": "KEY_ANIMATION",
    "status": "COMPLETED",
    "assigneeId": "clxxx...",
    "startDate": "2026-01-10T00:00:00.000Z",
    "dueDate": "2026-01-20T00:00:00.000Z"
  }
}
  • ●status の有効値: NOT_STARTED / IN_PROGRESS / COMPLETED / RETAKE
  • ●更新できる項目が1つも含まれていない場合は 400 になります。
  • ●外部発注の工程で発注伝票・納品・承認が揃っていない場合は 422 または 400(REQUIRES_PURCHASE_ORDER / REQUIRES_APPROVAL / REQUIRES_ORDER_DELIVERY)で拒否されます。

PATCH /api/v1/processes/bulk/status

複数の工程のステータスをまとめて更新します。

リクエスト

{
  "processIds": ["clxxx...", "clyyy..."],
  "status": "COMPLETED",
  "statusKey": "checking"      // 任意
}

レスポンス

{
  "data": { "updated": 2 }
}
  • ●1リクエストあたり最大100件です。
  • ●processIds に組織外の工程が1件でも含まれていると、何も更新せず 404 を返します。
  • ●途中で拒否された場合は、その時点までに更新できた件数を data.updated に入れてエラーを返します。