[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-scrum\u002Fdod\u002Fsave-settings":3,"docs-tabs-scrum\u002Fdod\u002Fsave-settings":6},{"content":4,"lastmod":5},"## Save DoD settings\n\n`POST \u002Fv1\u002Fscrum\u002Fgroups\u002F:groupId\u002Fdod\u002Ftypes\u002F:typeId\u002Fsettings`\n\nSets whether the checklist is required, the checklist items, and the participants of a Definition of Done type in a Scrum project. Items and participants are replaced entirely with the values from the request.\n\n## Parameters\n\n| Parameter | Type | Required | Description |\n|----------|-----|-------|----------|\n| `groupId` (path) | number | yes | Scrum project ID. List: [`GET \u002Fv1\u002Fworkgroups`](\u002Fdocs\u002Fentities\u002Fworkgroups\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| `requiredOption` | string | yes | `Y` — the DoD checklist is required for tasks of this type, `N` — it is not |\n| `items` | array | yes | Checklist items of the type. An empty array deletes all items |\n| `items[].TITLE` | string | yes | Item text. The field name is uppercase |\n| `participants` | array | yes | Participants of the type. An empty array deletes all participants |\n| `participants[].entityId` | string | yes | `user` |\n| `participants[].id` | number | yes | Employee ID. List: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers\u002Flist) |\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fscrum\u002Fgroups\u002F53\u002Fdod\u002Ftypes\u002F7\u002Fsettings\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"requiredOption\": \"Y\",\n    \"items\": [{ \"TITLE\": \"Code reviewed\" }, { \"TITLE\": \"Tests passed\" }],\n    \"participants\": [{ \"entityId\": \"user\", \"id\": 1 }]\n  }'\n```\n\n### curl — OAuth application\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fscrum\u002Fgroups\u002F53\u002Fdod\u002Ftypes\u002F7\u002Fsettings\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"requiredOption\": \"Y\",\n    \"items\": [{ \"TITLE\": \"Code reviewed\" }, { \"TITLE\": \"Tests passed\" }],\n    \"participants\": [{ \"entityId\": \"user\", \"id\": 1 }]\n  }'\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fscrum\u002Fgroups\u002F53\u002Fdod\u002Ftypes\u002F7\u002Fsettings', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    requiredOption: 'Y',\n    items: [{ TITLE: 'Code reviewed' }, { TITLE: 'Tests passed' }],\n    participants: [{ entityId: 'user', id: 1 }],\n  }),\n})\n\nconst { data } = await res.json()\nconsole.log(data.type.dodRequired)\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fscrum\u002Fgroups\u002F53\u002Fdod\u002Ftypes\u002F7\u002Fsettings', {\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    requiredOption: 'Y',\n    items: [{ TITLE: 'Code reviewed' }, { TITLE: 'Tests passed' }],\n    participants: [{ entityId: 'user', id: 1 }],\n  }),\n})\n\nconst { data } = await res.json()\nconsole.log(data.type.dodRequired)\n```\n\n## Response fields\n\n| Field | Type | Description |\n|------|-----|----------|\n| `success` | boolean | Always `true` on success |\n| `data.type.id` | number | DoD type ID |\n| `data.type.entityId` | number | ID of the Scrum project backlog the type belongs to |\n| `data.type.name` | string | Type name |\n| `data.type.sort` | number | Position of the type in the list |\n| `data.type.dodRequired` | string | Saved value of `requiredOption` |\n| `data.type.participants` | array | Saved participants in the format `{ \"id\": 1, \"entityId\": \"user\" }` |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"type\": {\n      \"id\": 7,\n      \"entityId\": 5,\n      \"name\": \"Technical task\",\n      \"sort\": 2,\n      \"dodRequired\": \"Y\",\n      \"participants\": [\n        {\n          \"id\": 1,\n          \"entityId\": \"user\"\n        }\n      ]\n    }\n  }\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` | `groupId` or `typeId` is not a positive integer |\n| 400 | `INVALID_PARAMS` | `requiredOption` is not passed or is not `Y` or `N` |\n| 400 | `INVALID_PARAMS` | `items` or `participants` is not passed or is not an array |\n| 400 | `INVALID_PARAMS` | The body is not a JSON object, for example an array |\n| 400 | `INVALID_PARAMS` | The body contains a field other than `requiredOption`, `items`, and `participants` |\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` | An `items` entry without the `TITLE` field, for example with lowercase `title`. `error.b24Code` is `TASKS_SDC_03`, message \"System error\" |\n| 422 | `BITRIX_ERROR` | An `items` entry is a string, not an object. `error.b24Code` is `0`, message \"Internal server error.\" |\n| 422 | `BITRIX_ERROR` | The project does not exist or the user has no access to it. `error.b24Code` is `TASKS_SDC_02` |\n\nFull list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## Known specifics\n\n- A participant with `\"entityId\": \"department\"` is not saved: the request returns success, but `data.type.participants` in the response is empty. Check the saved participants against the response.\n\n## See also\n\n- [Get DoD settings](\u002Fdocs\u002Fscrum\u002Fdod\u002Fsettings)\n- [Save a task's DoD list](\u002Fdocs\u002Fscrum\u002Fdod\u002Fsave-list)\n- [Definition of Done in Scrum](\u002Fdocs\u002Fscrum\u002Fdod)\n- [List employees](\u002Fdocs\u002Fentities\u002Fusers\u002Flist)\n",null,{},1795000570311]