【重要】[工数管理] プロジェクト登録・編集API変更のお知らせ

■概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

プロジェクトの登録・編集APIでプロジェクトタグをリクエストに含めることができるようになります。

これに伴い、事業所設定(設定>プロジェクトタグ)で「プロジェクトでのタグ付けを必須にする」が有効な場合、プロジェクト登録時のリクエストにプロジェクトタグが含まれていないとエラーになります。

■ 変更内容

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API:
プロジェクトの登録(POST /projects)
プロジェクトの編集(PATCH /projects/{id})

変更種別:
Breaking Change

変更内容:
本変更により、プロジェクトの登録・編集APIでプロジェクトタグ(project_tag_groups)の指定が可能になります。 これに伴い、事業所設定で「プロジェクトでのタグ付けを必須にする」が有効な場合、以下のバリデーションが追加されます。

  • プロジェクトの登録(POST):リクエストに有効なプロジェクトタグが含まれていない場合、エラーとなります。
  • プロジェクトの編集(PATCH):リクエストに project_tag_groups パラメータを含める場合、空の値での送信はエラーとなります。

変更理由:[変更を行う背景・理由]

これまでプロジェクト登録・編集APIではプロジェクトタグの指定に対応していなかったため、タグ必須設定時の判定を行っていませんでした。今回、同APIでのタグ設定機能の追加に伴い、画面操作と同様の必須チェックを適用いたします。

■ 変更スケジュール

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日:2026/10/14

変更リリース予定日:2026/11/26

■ 対応方法

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 対象となるお客様

事業所設定で「プロジェクトでのタグ付けを必須にする」を有効にしている方

■ 必要なご対応

プロジェクト登録API(POST)を利用する場合

リクエストに project_tag_groups パラメータを含めてリクエストを実行するよう、システムのご修正をお願いいたします。

プロジェクト編集API(PATCH)を利用する場合

既存のタグ未設定の更新リクエストには影響ありません。ただし、project_tag_groups パラメータを含めてリクエストを送る場合は、空値をセットしないようご注意ください。

■変更後のAPI仕様

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

エンドポイント:

プロジェクトの登録(POST /projects)
プロジェクトの編集(PATCH /projects/{id})

リクエスト:共通で以下のリクエストが追加されます。

 "project_tag_groups": [
    {
      "tag_group_id": 1,
      "tag_id": 1
    }
  ]