[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-entities\u002Fcatalog-price-types\u002Fupdate":3,"docs-tabs-entities\u002Fcatalog-price-types\u002Fupdate":6},{"content":4,"lastmod":5},"## Update a price type\n\n`PATCH \u002Fv1\u002Fcatalog-price-types\u002F:id`\n\nPartially updates a catalog price type, preserving the values of fields omitted from the request. The request body is flat, without a `fields` wrapper.\n\n## Parameters\n\n| Parameter | Type | Required | Description |\n|----------|-----|-------|----------|\n| `id` (path) | number | yes | Price type ID, a non-negative integer. List: [List price types](.\u002Flist.md). |\n\n## Request fields (body)\n\nSend at least one editable field.\n\n| Field | Type | Required | Description |\n|------|-----|-------|----------|\n| `name` | string | no | Price type name. |\n| `sort` | number | no | Sort order in the Bitrix24 interface. |\n| `xmlId` | string \\| null | no | External identifier for import and export integrations. |\n| `id` | number | no | `RO`. Price type ID. List: [List price types](.\u002Flist.md). |\n| `base` | string | no | `RO`. Base price type flag, set by the system. |\n| `createdBy` | number \\| null | no | `RO`. ID of the user who created the record. List: [List users](\u002Fdocs\u002Fentities\u002Fusers\u002Flist). |\n| `modifiedBy` | number \\| null | no | `RO`. ID of the user who last updated the record. List: [List users](\u002Fdocs\u002Fentities\u002Fusers\u002Flist). |\n| `dateCreate` | string \\| null | no | `RO`. Creation date and time in ISO 8601 format. |\n| `timestampX` | string \\| null | no | `RO`. Last update date and time in ISO 8601 format. |\n\nFields marked `RO` are read-only. Do not include them in the request body.\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcatalog-price-types\u002F19\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\": \"Wholesale 2026\", \"sort\": 210}'\n```\n\n### curl — OAuth application\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcatalog-price-types\u002F19\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\": \"Wholesale 2026\", \"sort\": 210}'\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcatalog-price-types\u002F19', {\n  method: 'PATCH',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\"name\": \"Wholesale 2026\", \"sort\": 210}),\n})\n\nconst { success, data } = await res.json()\nconsole.log(data)\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcatalog-price-types\u002F19', {\n  method: 'PATCH',\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({\"name\": \"Wholesale 2026\", \"sort\": 210}),\n})\n\nconst { success, data } = await res.json()\nconsole.log(data)\n```\n\n## Response fields\n\nA successful response returns `200` and the complete updated price type.\n\n| Field | Type | Description |\n|------|-----|----------|\n| `success` | boolean | Always `true` on success. |\n| `data` | object | Price type object. |\n| `data.id` | number | `RO`. Price type ID. List: [List price types](.\u002Flist.md). Pass this value in `catalogGroupId` when working with [catalog prices](\u002Fdocs\u002Fentities\u002Fcatalog-prices). |\n| `data.name` | string | Price type name. |\n| `data.base` | string | `RO`. `Y` — the account's base price type, `N` — another type. |\n| `data.xmlId` | string \\| null | External identifier for integrations. |\n| `data.sort` | number | Sort order in the Bitrix24 interface. |\n| `data.createdBy` | number \\| null | `RO`. ID of the user who created the record. List: [List users](\u002Fdocs\u002Fentities\u002Fusers\u002Flist). |\n| `data.modifiedBy` | number \\| null | `RO`. ID of the user who last updated the record. List: [List users](\u002Fdocs\u002Fentities\u002Fusers\u002Flist). |\n| `data.dateCreate` | string \\| null | `RO`. Creation date and time in ISO 8601 format. |\n| `data.timestampX` | string \\| null | `RO`. Last update date and time in ISO 8601 format. |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"base\": \"N\",\n    \"createdBy\": 1295,\n    \"dateCreate\": \"2026-10-14T17:18:58.000Z\",\n    \"id\": 19,\n    \"modifiedBy\": 1295,\n    \"name\": \"Wholesale 2026\",\n    \"sort\": 210,\n    \"timestampX\": \"2026-10-14T17:18:59.000Z\",\n    \"xmlId\": \"WHOLESALE\"\n  }\n}\n```\n\n## Error response example\n\n400 — an attempt to change `base`, so the price type was not updated:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"READONLY_FIELD\",\n    \"message\": \"Field 'base' is read-only and cannot be set\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|----------|\n| 404 | `ENTITY_NOT_FOUND` | No price type exists with the specified `id`. |\n| 400 | `INVALID_PARAMS` | `id` is not a non-negative integer, for example `abc`. |\n| 400 | `EMPTY_UPDATE_BODY` | The body is empty or is not a JSON object. Send at least one editable field. |\n| 400 | `READONLY_FIELD` | The body contains a field marked `RO`. Remove it from the request. |\n| 400 | `INVALID_PARAMS` | An object or array was passed in a string or numeric field. |\n| 400 | `INVALID_PARAMS` | Bitrix24 rejected the request parameters. |\n| 422 | `BITRIX_ERROR` | Bitrix24 rejected the request. The reason is in `error.message`. |\n| 403 | `BITRIX_ACCESS_DENIED` | The user does not have the Bitrix24 “Manage price types” permission. |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | The key is in read-only mode. |\n| 403 | `SCOPE_DENIED` | The key does not have the `catalog` scope. |\n| 401 | `MISSING_API_KEY` | The `X-Api-Key` header was omitted. |\n| 401 | `TOKEN_MISSING` | The key has no Bitrix24 tokens configured. For an OAuth application key, check the user session. |\n\nFor the full list of common API errors, see [Errors](\u002Fdocs\u002Ferrors).\n\n## See also\n\n- [Get a price type](.\u002Fget.md)\n- [Create a price type](.\u002Fcreate.md)\n- [List price types](.\u002Flist.md)\n- [Delete a price type](.\u002Fdelete.md)\n- [Price type fields](.\u002Ffields.md)\n","2026-10-14",{},1794739330644]