工程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 に入れてエラーを返します。