[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-scrum\u002Fdod\u002Fsave-list":3,"docs-tabs-scrum\u002Fdod\u002Fsave-list":6},{"content":4,"lastmod":5},"## Save a task's DoD list\n\n`POST \u002Fv1\u002Fscrum\u002Ftasks\u002F:taskId\u002Fdod\u002F:typeId`\n\nWrites the Definition of Done checklist items for a Scrum project task under the selected DoD type. The task's saved list is replaced with the items from the request.\n\n## Parameters\n\n| Parameter | Type | Required | Description |\n|----------|-----|-------|----------|\n| `taskId` (path) | number | yes | Task ID. Project task list: [`GET \u002Fv1\u002Ftasks?filter[groupId]=53`](\u002Fdocs\u002Fentities\u002Ftasks\u002Flist) |\n| `typeId` (path) | number | yes | DoD type ID. List: [`GET \u002Fv1\u002Fscrum\u002Fgroups\u002F:groupId\u002Fdod\u002Fsettings`](\u002Fdocs\u002Fscrum\u002Fdod\u002Fsettings), field `data.types[].id` |\n\n## Request fields (body)\n\n| Field | Type | Required | Description |\n|------|-----|-------|----------|\n| `items` | array | yes | The task's checklist items. An empty array clears the list |\n| `items[].TITLE` | string | yes | Item text. The field name is uppercase |\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fscrum\u002Ftasks\u002F3671\u002Fdod\u002F7\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"items\": [\n      { \"TITLE\": \"Code reviewed\" },\n      { \"TITLE\": \"Tests passed\" }\n    ]\n  }'\n```\n\n### curl — OAuth application\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fscrum\u002Ftasks\u002F3671\u002Fdod\u002F7\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"items\": [\n      { \"TITLE\": \"Code reviewed\" },\n      { \"TITLE\": \"Tests passed\" }\n    ]\n  }'\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fscrum\u002Ftasks\u002F3671\u002Fdod\u002F7', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    items: [\n      { TITLE: 'Code reviewed' },\n      { TITLE: 'Tests passed' },\n    ],\n  }),\n})\n\nconst { success } = await res.json()\nconsole.log(success)\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fscrum\u002Ftasks\u002F3671\u002Fdod\u002F7', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    items: [\n      { TITLE: 'Code reviewed' },\n      { TITLE: 'Tests passed' },\n    ],\n  }),\n})\n\nconst { success } = await res.json()\nconsole.log(success)\n```\n\n## Response fields\n\n| Field | Type | Description |\n|------|-----|----------|\n| `success` | boolean | Always `true` on success |\n| `data` | string | Empty string |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": \"\"\n}\n```\n\n## Error response example\n\n422 — no type with this `typeId`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Could not find the type.\",\n    \"b24Code\": \"TASKS_SDC_03\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|----------|\n| 400 | `INVALID_PARAMS` | `taskId` or `typeId` is not a positive integer |\n| 400 | `INVALID_PARAMS` | `items` is not passed or is not an array |\n| 400 | `INVALID_PARAMS` | The body is not a JSON object or contains a field other than `items` |\n| 400 | `FST_ERR_CTP_EMPTY_JSON_BODY` | Request with `Content-Type: application\u002Fjson` and an empty body |\n| 401 | `MISSING_API_KEY` | `X-Api-Key` is not passed |\n| 401 | `TOKEN_MISSING` | The key has no configured tokens |\n| 403 | `SCOPE_DENIED` | The key lacks the `task` scope |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | The key is in read-only mode |\n| 422 | `BITRIX_ERROR` | No type with this `typeId`. `error.b24Code` is `TASKS_SDC_03`, message \"Could not find the type.\" |\n| 422 | `BITRIX_ERROR` | No task with this `taskId`, or an `items` entry without the `TITLE` field. `error.b24Code` is `TASKS_SDC_05`, message \"Error saving the list\" |\n\nFull list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## Known specifics\n\n- The API does not check whether the type belongs to the task's project: the list is saved even with the `typeId` of a type from another Scrum project. Take the type ID from the DoD settings of the project that contains the task.\n\n## See also\n\n- [Get DoD settings](\u002Fdocs\u002Fscrum\u002Fdod\u002Fsettings)\n- [Save DoD settings](\u002Fdocs\u002Fscrum\u002Fdod\u002Fsave-settings)\n- [Check whether a task needs DoD](\u002Fdocs\u002Fscrum\u002Fdod\u002Fnecessary)\n- [Definition of Done in Scrum](\u002Fdocs\u002Fscrum\u002Fdod)\n",null,{},1795000570190]