プロジェクトの名前変更
既存のプロジェクトの名前やその他のプロパティを更新します。名前が変更されると、プロジェクトのスラッグは新しい名前に基づいて自動的に再生成されます。
基本的な例
mutation RenameProject {
editProject(input: {
projectId: "project_abc123"
name: "Q2 Marketing Campaign"
}) {
id
name
slug
}
}
高度な例
mutation EditProjectAdvanced {
editProject(input: {
projectId: "project_abc123"
name: "Q2 Marketing Campaign"
description: "Campaign for Q2 product launch"
color: "#3B82F6"
icon: "campaign"
category: MARKETING
todoAlias: "Task"
hideRecordCount: false
}) {
id
name
slug
description
color
icon
category
todoAlias
hideRecordCount
}
}
入力パラメータ
パラメータ |
型 |
必須 |
説明 |
projectId |
String! |
✅ はい |
編集するプロジェクトのID |
name |
String |
いいえ |
プロジェクトの新しい名前 |
slug |
String |
いいえ |
カスタムのURLフレンドリースラッグ(提供されない場合は自動生成) |
description |
String |
いいえ |
プロジェクトの説明 |
color |
String |
いいえ |
プロジェクトの16進カラーコード(例:#3B82F6) |
icon |
String |
いいえ |
プロジェクトのアイコン識別子 |
category |
ProjectCategory |
いいえ |
プロジェクトのカテゴリ |
todoAlias |
String |
いいえ |
このプロジェクト内のレコードのカスタム名 |
hideRecordCount |
Boolean |
いいえ |
UI内でのレコードカウントを非表示にするかどうか |
showTimeSpentInTodoList |
Boolean |
いいえ |
リスト内での時間追跡を表示 |
showTimeSpentInProject |
Boolean |
いいえ |
プロジェクトビュー内での時間追跡を表示 |
image |
ImageInput |
いいえ |
プロジェクトの画像/カバー |
todoFields |
[TodoFieldInput] |
いいえ |
カスタムフィールドの設定 |
coverConfig |
TodoCoverConfigInput |
いいえ |
カバー表示の設定 |
features |
[ProjectFeatureInput] |
いいえ |
プロジェクトの機能トグル |
sequenceCustomFieldId |
String |
いいえ |
レコードのシーケンシングに使用するカスタムフィールド |
ProjectCategory 値
値 |
説明 |
PERSONAL |
個人プロジェクト |
BUSINESS |
ビジネスプロジェクト |
MARKETING |
マーケティングキャンペーン |
DEVELOPMENT |
開発プロジェクト |
DESIGN |
デザインプロジェクト |
OPERATIONS |
業務タスク |
SALES |
営業活動 |
SUPPORT |
サポートチケット |
FINANCE |
財務追跡 |
HR |
人事 |
LEGAL |
法的事項 |
PROCUREMENT |
調達プロセス |
レスポンスフィールド
更新されたプロジェクトオブジェクトがすべてのフィールドと共に返されます。主要なフィールドには以下が含まれます:
フィールド |
型 |
説明 |
id |
String! |
プロジェクトID |
name |
String! |
プロジェクト名 |
slug |
String! |
URLフレンドリースラッグ |
description |
String |
プロジェクトの説明 |
color |
String |
16進カラーコード |
icon |
String |
アイコン識別子 |
category |
ProjectCategory |
プロジェクトカテゴリ |
todoAlias |
String |
カスタムレコード名 |
hideRecordCount |
Boolean! |
レコードカウントの可視性設定 |
createdAt |
DateTime! |
作成タイムスタンプ |
updatedAt |
DateTime! |
最終更新タイムスタンプ |
必要な権限
ロール |
プロジェクトを編集可能 |
OWNER |
✅ はい |
ADMIN |
✅ はい |
MEMBER |
❌ いいえ |
エラー応答
プロジェクトが見つかりません
{
"errors": [{
"message": "Project was not found.",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
権限が不足しています
{
"errors": [{
"message": "You don't have permission to edit this project",
"extensions": {
"code": "FORBIDDEN"
}
}]
}
重要な注意事項
- スラッグ生成: プロジェクトのスラッグは名前が変更されると自動的に生成されます。カスタムスラッグを提供することもできます。
- スラッグの競合: スラッグが既存の会社のスラッグと競合する場合、システムは番号を追加します(例:
my-project-1
)。
- HTMLのサニタイズ: セキュリティのために、説明フィールドからHTMLタグは自動的に削除されます。
- 部分的な更新:
projectId
を除いて、すべてのフィールドはオプションです - 更新したいフィールドのみを提供してください。
- カテゴリ: カテゴリフィールドにはProjectCategory列挙値を使用してください。
- 画像処理: ImageInputを介してプロジェクト画像のアップロード、更新、または削除をサポートします。
関連操作