items_bulk_patch write destructive 複数タスク(最大 25 件)に同じフィールド変更を一括適用する。単一タスクは items_patch を使う。実行には確認が必要。
パラメータ 13 · 入力スキーマ
| 引数 | 型 | 必須 |
|---|---|---|
| item_refs | array | yes |
| title | string | no |
| detail | string | no |
| due_date | string | no |
| due_time | string | no |
| start_date | string | no |
| priority | string | no |
| labels | array | no |
| archived_at | string | no |
| area_id | string | no |
| kind | string | no |
| estimate | string | no |
| sprint_id | string | no |
{
"type": "object",
"properties": {
"item_refs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of 2-25 item refs like [\"#42\",\"WORK#43\"] (project prefix optional; bare \"#42\" resolves owner-wide)."
},
"title": {
"type": "string"
},
"detail": {
"type": "string",
"description": "Replaces detail of every target item."
},
"due_date": {
"type": "string",
"format": "date"
},
"due_time": {
"type": "string",
"description": "Time-of-day for the due date in HH:MM (JST, 24h). null to clear (all-day). Applies to every target item."
},
"start_date": {
"type": "string",
"format": "date"
},
"priority": {
"type": "string",
"enum": [
"urgent",
"high",
"normal",
"low"
]
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"archived_at": {
"type": "string",
"description": "ISO 8601 datetime to archive every item. Pass null to unarchive. Omit to leave unchanged."
},
"area_id": {
"type": "string",
"description": "Area id to assign to every target item (must belong to each item's own project). Pass null to clear the area on every item. Omit to leave unchanged. For path-based single-item assignment prefer project_areas_assign_item."
},
"kind": {
"type": "string",
"description": "Work-item kind key to set on every target item (lowercase / digits / - _, e.g. \"story\", \"bug\"). Pass null to clear the kind on every item. Omit to leave unchanged. Not validated against each project's custom kinds — built-in kinds always work."
},
"estimate": {
"type": "string",
"description": "Estimate value to set on every target item (must match each project's estimate unit, e.g. numeric for sp/hours). Pass null to clear the estimate on every item. Omit to leave unchanged."
},
"sprint_id": {
"type": "string",
"description": "Sprint id to assign every target item to (must belong to each item's own project). Pass null to remove every item from its (non-closed) sprint. Omit to leave unchanged."
}
},
"required": [
"item_refs"
]
}