[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-entities\u002Fwarehouses\u002Fupdate":3,"docs-tabs-entities\u002Fwarehouses\u002Fupdate":6},{"content":4,"lastmod":5},"\n## Update a warehouse\n\n`PATCH \u002Fv1\u002Fwarehouses\u002F:id`\n\nUpdates a warehouse. Pass only the fields you are changing, flat at the root of the JSON. The fields you pass replace the current values; the rest remain unchanged.\n\n## Path parameters\n\n| Parameter | Type | Description |\n|----------|-----|---------|\n| `id` | number | Warehouse identifier. List: [`GET \u002Fv1\u002Fwarehouses`](\u002Fdocs\u002Fentities\u002Fwarehouses\u002Flist) |\n\n## Request fields (body)\n\nAny subset of the warehouse's editable fields — all optional.\n\n| Parameter | Type | Description |\n|----------|-----|---------|\n| `title` | string | Warehouse name |\n| `address` | string | Warehouse address |\n| `active` | string | Active flag: `\"Y\"` \u002F `\"N\"` |\n| `issuingCenter` | string | Order pickup point: `\"Y\"` \u002F `\"N\"` |\n| `description` | string | Warehouse description |\n| `phone` | string | Contact phone |\n| `email` | string | Contact email |\n| `schedule` | string | Working hours |\n| `sort` | number | Sort order |\n| `code` | string | Symbolic code |\n| `xmlId` | string | External identifier |\n| `gpsN` | number | Geographic latitude |\n| `gpsS` | number | Geographic longitude |\n| `userId` | number | Responsible employee. List: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers\u002Flist) |\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fwarehouses\u002F1\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Central warehouse\",\n    \"sort\": 50\n  }'\n```\n\n### curl — OAuth application\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fwarehouses\u002F1\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Central warehouse\",\n    \"sort\": 50\n  }'\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fwarehouses\u002F1', {\n  method: 'PATCH',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    title: 'Central warehouse',\n    sort: 50,\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fwarehouses\u002F1', {\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({\n    title: 'Central warehouse',\n    sort: 50,\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Response fields\n\nThe updated warehouse object is returned in the `data` field.\n\n| Field | Type | Description |\n|------|-----|---------|\n| `data.id` | number | Warehouse identifier |\n| `data.title` | string | Warehouse name |\n| `data.address` | string | Warehouse address |\n| `data.active` | string | Active flag: `\"Y\"` \u002F `\"N\"` |\n| `data.issuingCenter` | string | Order pickup point flag: `\"Y\"` \u002F `\"N\"` |\n| `data.description` | string \\| null | Warehouse description. `null` if not set |\n| `data.phone` | string \\| null | Contact phone. `null` if not set |\n| `data.email` | string \\| null | Contact email. `null` if not set |\n| `data.schedule` | string \\| null | Working hours. `null` if not set |\n| `data.sort` | number | Sort order |\n| `data.code` | string \\| null | Symbolic code. `null` if not set |\n| `data.xmlId` | string \\| null | External identifier. `null` if not set |\n| `data.gpsN` | number \\| null | Geographic latitude. `null` if not set |\n| `data.gpsS` | number \\| null | Geographic longitude. `null` if not set |\n| `data.imageId` | object \\| null | Warehouse image: `{ \"id\", \"url\" }` or `null` |\n| `data.userId` | number \\| null | Responsible employee — identifier from [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers\u002Flist). `null` for system warehouses |\n| `data.modifiedBy` | number | Identifier of the user from [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers\u002Flist) who last modified the warehouse. After an update, this is the user the API key was issued for |\n| `data.dateCreate` | datetime \\| null | Creation date. `null` for some system warehouses, for example marketplaces |\n| `data.dateModify` | datetime | Last modification date |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 1,\n    \"title\": \"Central warehouse\",\n    \"address\": \"1 Harbour Street, Amsterdam\",\n    \"active\": \"Y\",\n    \"issuingCenter\": \"N\",\n    \"description\": \"Central warehouse\",\n    \"phone\": \"+12025550123\",\n    \"email\": \"warehouse@example.com\",\n    \"schedule\": \"Mon–Fri 9:00–20:00\",\n    \"sort\": 50,\n    \"code\": \"main\",\n    \"xmlId\": null,\n    \"gpsN\": 52.377956,\n    \"gpsS\": 4.897070,\n    \"imageId\": null,\n    \"userId\": 1,\n    \"modifiedBy\": 1,\n    \"dateCreate\": \"2024-01-15T09:00:00+00:00\",\n    \"dateModify\": \"2026-06-02T12:04:25+00:00\"\n  }\n}\n```\n\n## Error response example\n\n404 — a warehouse with this `id` does not exist:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"ENTITY_NOT_FOUND\",\n    \"message\": \"store does not exist.\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `id` is not a canonical positive integer: `12.5`, `12abc`, `1e2`, `007` are rejected before Bitrix24 is called |\n| 401 | `TOKEN_MISSING` | The API key has no configured tokens |\n| 403 | `SCOPE_DENIED` | The API key does not have the `catalog` scope |\n| 404 | `ENTITY_NOT_FOUND` | A warehouse with the specified `id` does not exist |\n\nThe full list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## Known specifics\n\n**A nonexistent warehouse is `404`.** Updating a warehouse by an unknown `id` returns `404` with the code `ENTITY_NOT_FOUND`. The `message` field still carries the Bitrix24 text `store does not exist.`.\n\n## See also\n\n- [Get a warehouse](\u002Fdocs\u002Fentities\u002Fwarehouses\u002Fget)\n- [Create a warehouse](\u002Fdocs\u002Fentities\u002Fwarehouses\u002Fcreate)\n- [Delete a warehouse](\u002Fdocs\u002Fentities\u002Fwarehouses\u002Fdelete)\n- [API reference](\u002Fdocs\u002Fapi-reference)\n","2026-10-28",{},1794739443733]