Updates an object of type item in Dynamics 365 Business Central

Request

Security

oAuthoauth2 (OAuth 2.0)
OAuth2oauth2 (OAuth 2.0)

Path

company_idstring (uuid)required
(v1.0) id for company

Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
item_idstring (uuid)required
(v1.0) id for item

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1

Headers

Content-Typestringrequired
(v1.0) application/json
If-Matchstringrequired
(v1.0) Required. When this request header is included and the eTag provided does not match the current tag on the entity, this will not be updated.

Example: true

Body application/json required

numberstring
(v1.0) The number property for the Dynamics 365 Business Central item entity

Example: null
<= 20 characters
displayNamestring
(v1.0) The displayName property for the Dynamics 365 Business Central item entity

Example: null
<= 100 characters
typestring
(v1.0) The type property for the Dynamics 365 Business Central item entity

Example: Inventory
itemCategoryIdstring (uuid)
(v1.0) The itemCategoryId property for the Dynamics 365 Business Central item entity

Example: 00000000-0000-0000-0000-000000000000
itemCategorycodestring
(v1.0) The itemCategoryCode property for the Dynamics 365 Business Central item entity

Example:
<= 20 characters
blockedboolean
(v1.0) The blocked property for the Dynamics 365 Business Central item entity

Example: false
baseUnitOfMeasureIdstring (uuid)
(v1.0) The baseUnitOfMeasureId property for the Dynamics 365 Business Central item entity

Example: 902d1241-2906-f011-9346-000d3ac96156
gtinstring
(v1.0) The gtin property for the Dynamics 365 Business Central item entity

Example:
<= 14 characters
unitPricenumber (decimal)
(v1.0) The unitPrice property for the Dynamics 365 Business Central item entity

Example: 999
priceIncludesTaxboolean
(v1.0) The priceIncludesTax property for the Dynamics 365 Business Central item entity

Example: false
unitCostnumber (decimal)
(v1.0) The unitCost property for the Dynamics 365 Business Central item entity

Example: 50
taxGroupIdstring (uuid)
(v1.0) The taxGroupId property for the Dynamics 365 Business Central item entity

Example: 00000000-0000-0000-0000-000000000000
taxGroupcodestring
(v1.0) The taxGroupCode property for the Dynamics 365 Business Central item entity

Example:
<= 20 characters

Responses

(v1.0) Succesfully updated the specifieditem

Body application/json

idstring (uuid)
(v1.0) The id property for the Dynamics 365 Business Central item entity

Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
numberstring
(v1.0) The number property for the Dynamics 365 Business Central item entity

Example: null
<= 20 characters
displayNamestring
(v1.0) The displayName property for the Dynamics 365 Business Central item entity

Example: null
<= 100 characters
typestring
(v1.0) The type property for the Dynamics 365 Business Central item entity

Example: null
itemCategoryIdstring (uuid)
(v1.0) The itemCategoryId property for the Dynamics 365 Business Central item entity

Example: null
itemCategoryCodestring
(v1.0) The itemCategoryCode property for the Dynamics 365 Business Central item entity

Example: null
<= 20 characters
blockedboolean
(v1.0) The blocked property for the Dynamics 365 Business Central item entity

Example: null
baseUnitOfMeasureIdstring (uuid)
(v1.0) The baseUnitOfMeasureId property for the Dynamics 365 Business Central item entity

Example: null
baseUnitOfMeasureobject (unitofmeasuretype)
Show 7 properties
- codestring
  (v1.0) The code property for the Dynamics 365 Business Central unitofmeasuretype entity
  
  Example: null
  <= 10 characters
- displayNamestring
  (v1.0) The displayName property for the Dynamics 365 Business Central unitofmeasuretype entity
  
  Example: null
  <= 50 characters
- symbolstring
  (v1.0) The symbol property for the Dynamics 365 Business Central unitofmeasuretype entity
  
  Example: null
  <= 10 characters
- unitConversionobject (itemunitofmeasureconversiontype)
  Show 5 properties
  - toUnitOfMeasurestring
    (v1.0) The toUnitOfMeasure property for the Dynamics 365 Business Central itemunitofmeasureconversiontype entity
    
    Example: null
    <= 10 characters
  - fromToConversionRatenumber (decimal)
    (v1.0) The fromToConversionRate property for the Dynamics 365 Business Central itemunitofmeasureconversiontype entity
    
    Example: null
  - pictureArray of objects (picture)
    Show 6 properties
    idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central picture entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    widthinteger (int32)
    (v1.0) The width property for the Dynamics 365 Business Central picture entity
    
    Example: null
    heightinteger (int32)
    (v1.0) The height property for the Dynamics 365 Business Central picture entity
    
    Example: null
    contentTypestring
    (v1.0) The contentType property for the Dynamics 365 Business Central picture entity
    
    Example: null
    <= 100 characters
    content@odata.mediaEditLinkstring (uri)
    (v1.0) The content@odata.mediaEditLink property for the Dynamics 365 Business Central picture entity
    
    Example: null
    content@odata.mediaReadLinkstring (uri)
    (v1.0) The content@odata.mediaReadLink property for the Dynamics 365 Business Central picture entity
    
    Example: null
  - defaultDimensionsArray of objects (defaultDimensions)
    Show 9 properties
    parentIdstring (uuid)
    (v1.0) The parentId property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    dimensionIdstring (uuid)
    (v1.0) The dimensionId property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    dimensionCodestring
    (v1.0) The dimensionCode property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: null
    <= 20 characters
    dimensionValueIdstring (uuid)
    (v1.0) The dimensionValueId property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: null
    dimensionValueCodestring
    (v1.0) The dimensionValueCode property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: null
    <= 20 characters
    postingValidationstring
    (v1.0) The postingValidation property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: null
    accountobject (account)
    dimensionobject (dimension)
    dimensionValueobject (dimensionValue)
  - itemCategoryobject (itemCategory)
    Show 4 properties
    idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central itemCategory entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    codestring
    (v1.0) The code property for the Dynamics 365 Business Central itemCategory entity
    
    Example: I2K5893
    <= 20 characters
    displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central itemCategory entity
    
    Example: null
    <= 100 characters
    lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central itemCategory entity
    
    Example: null
- pictureArray of objects (picture)
  Show 6 properties
  - idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central picture entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - widthinteger (int32)
    (v1.0) The width property for the Dynamics 365 Business Central picture entity
    
    Example: null
  - heightinteger (int32)
    (v1.0) The height property for the Dynamics 365 Business Central picture entity
    
    Example: null
  - contentTypestring
    (v1.0) The contentType property for the Dynamics 365 Business Central picture entity
    
    Example: null
    <= 100 characters
  - content@odata.mediaEditLinkstring (uri)
    (v1.0) The content@odata.mediaEditLink property for the Dynamics 365 Business Central picture entity
    
    Example: null
  - content@odata.mediaReadLinkstring (uri)
    (v1.0) The content@odata.mediaReadLink property for the Dynamics 365 Business Central picture entity
    
    Example: null
- defaultDimensionsArray of objects (defaultDimensions)
  Show 9 properties
  - parentIdstring (uuid)
    (v1.0) The parentId property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - dimensionIdstring (uuid)
    (v1.0) The dimensionId property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - dimensionCodestring
    (v1.0) The dimensionCode property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: null
    <= 20 characters
  - dimensionValueIdstring (uuid)
    (v1.0) The dimensionValueId property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: null
  - dimensionValueCodestring
    (v1.0) The dimensionValueCode property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: null
    <= 20 characters
  - postingValidationstring
    (v1.0) The postingValidation property for the Dynamics 365 Business Central defaultDimensions entity
    
    Example: null
  - accountobject (account)
    Show 7 properties
    idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central account entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    numberstring
    (v1.0) The number property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 20 characters
    displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 100 characters
    categorystring
    (v1.0) The category property for the Dynamics 365 Business Central account entity
    
    Example: null
    subCategorystring
    (v1.0) The subCategory property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 80 characters
    blockedboolean
    (v1.0) The blocked property for the Dynamics 365 Business Central account entity
    
    Example: null
    lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central account entity
    
    Example: null
  - dimensionobject (dimension)
    Show 5 properties
    idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central dimension entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    codestring
    (v1.0) The code property for the Dynamics 365 Business Central dimension entity
    
    Example: null
    <= 20 characters
    displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central dimension entity
    
    Example: null
    <= 30 characters
    lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central dimension entity
    
    Example: null
    dimensionValuesArray of objects (dimensionValue)
  - dimensionValueobject (dimensionValue)
    Show 4 properties
    idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    codestring
    (v1.0) The code property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 20 characters
    displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 50 characters
    lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
- itemCategoryobject (itemCategory)
  Show 4 properties
  - idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central itemCategory entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - codestring
    (v1.0) The code property for the Dynamics 365 Business Central itemCategory entity
    
    Example: I2K5893
    <= 20 characters
  - displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central itemCategory entity
    
    Example: null
    <= 100 characters
  - lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central itemCategory entity
    
    Example: null
gtinstring
(v1.0) The gtin property for the Dynamics 365 Business Central item entity

Example: null
<= 14 characters
inventorynumber (decimal)
(v1.0) The inventory property for the Dynamics 365 Business Central item entity

Example: null
unitPricenumber (decimal)
(v1.0) The unitPrice property for the Dynamics 365 Business Central item entity

Example: null
priceIncludesTaxboolean
(v1.0) The priceIncludesTax property for the Dynamics 365 Business Central item entity

Example: null
unitCostnumber (decimal)
(v1.0) The unitCost property for the Dynamics 365 Business Central item entity

Example: null
taxGroupIdstring (uuid)
(v1.0) The taxGroupId property for the Dynamics 365 Business Central item entity

Example: null
taxGroupCodestring
(v1.0) The taxGroupCode property for the Dynamics 365 Business Central item entity

Example: null
<= 20 characters
lastModifiedDateTimestring (date-time)
(v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central item entity

Example: null
pictureArray of objects (picture)
Show 6 properties
- idstring (uuid)
  (v1.0) The id property for the Dynamics 365 Business Central picture entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- widthinteger (int32)
  (v1.0) The width property for the Dynamics 365 Business Central picture entity
  
  Example: null
- heightinteger (int32)
  (v1.0) The height property for the Dynamics 365 Business Central picture entity
  
  Example: null
- contentTypestring
  (v1.0) The contentType property for the Dynamics 365 Business Central picture entity
  
  Example: null
  <= 100 characters
- content@odata.mediaEditLinkstring (uri)
  (v1.0) The content@odata.mediaEditLink property for the Dynamics 365 Business Central picture entity
  
  Example: null
- content@odata.mediaReadLinkstring (uri)
  (v1.0) The content@odata.mediaReadLink property for the Dynamics 365 Business Central picture entity
  
  Example: null
defaultDimensionsArray of objects (defaultDimensions)
Show 9 properties
- parentIdstring (uuid)
  (v1.0) The parentId property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- dimensionIdstring (uuid)
  (v1.0) The dimensionId property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- dimensionCodestring
  (v1.0) The dimensionCode property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: null
  <= 20 characters
- dimensionValueIdstring (uuid)
  (v1.0) The dimensionValueId property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: null
- dimensionValueCodestring
  (v1.0) The dimensionValueCode property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: null
  <= 20 characters
- postingValidationstring
  (v1.0) The postingValidation property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: null
- accountobject (account)
  Show 7 properties
  - idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central account entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - numberstring
    (v1.0) The number property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 20 characters
  - displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 100 characters
  - categorystring
    (v1.0) The category property for the Dynamics 365 Business Central account entity
    
    Example: null
  - subCategorystring
    (v1.0) The subCategory property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 80 characters
  - blockedboolean
    (v1.0) The blocked property for the Dynamics 365 Business Central account entity
    
    Example: null
  - lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central account entity
    
    Example: null
- dimensionobject (dimension)
  Show 5 properties
  - idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central dimension entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - codestring
    (v1.0) The code property for the Dynamics 365 Business Central dimension entity
    
    Example: null
    <= 20 characters
  - displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central dimension entity
    
    Example: null
    <= 30 characters
  - lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central dimension entity
    
    Example: null
  - dimensionValuesArray of objects (dimensionValue)
    Show 4 properties
    idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    codestring
    (v1.0) The code property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 20 characters
    displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 50 characters
    lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
- dimensionValueobject (dimensionValue)
  Show 4 properties
  - idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - codestring
    (v1.0) The code property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 20 characters
  - displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 50 characters
  - lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
itemCategoryobject (itemCategory)
Show 4 properties
- idstring (uuid)
  (v1.0) The id property for the Dynamics 365 Business Central itemCategory entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- codestring
  (v1.0) The code property for the Dynamics 365 Business Central itemCategory entity
  
  Example: I2K5893
  <= 20 characters
- displayNamestring
  (v1.0) The displayName property for the Dynamics 365 Business Central itemCategory entity
  
  Example: null
  <= 100 characters
- lastModifiedDateTimestring (date-time)
  (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central itemCategory entity
  
  Example: null

patch /companies({company_id})/items({item_id})

curl -X PATCH \
  'https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(2a2dfc50-f21b-4ab0-8f89-463efd0dfce4)/items(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'If-Match: true' \
  -d '{
  "number": null,
  "displayName": null,
  "type": "Inventory",
  "itemCategoryId": "00000000-0000-0000-0000-000000000000",
  "itemCategorycode": "",
  "blocked": false,
  "baseUnitOfMeasureId": "902d1241-2906-f011-9346-000d3ac96156",
  "gtin": "",
  "unitPrice": 999,
  "priceIncludesTax": false,
  "unitCost": 50,
  "taxGroupId": "00000000-0000-0000-0000-000000000000",
  "taxGroupcode": ""
}'

const url = 'https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(2a2dfc50-f21b-4ab0-8f89-463efd0dfce4)/items(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)';
const options = {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'If-Match': 'true',
    Authorization: 'Bearer <YOUR_TOKEN_HERE>'
  },
  body: '{"number":null,"displayName":null,"type":"Inventory","itemCategoryId":"00000000-0000-0000-0000-000000000000","itemCategorycode":"","blocked":false,"baseUnitOfMeasureId":"902d1241-2906-f011-9346-000d3ac96156","gtin":"","unitPrice":999,"priceIncludesTax":false,"unitCost":50,"taxGroupId":"00000000-0000-0000-0000-000000000000","taxGroupcode":""}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

const fetch = require('node-fetch');

const url = 'https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(2a2dfc50-f21b-4ab0-8f89-463efd0dfce4)/items(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)';
const options = {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'If-Match': 'true',
    Authorization: 'Bearer <YOUR_TOKEN_HERE>'
  },
  body: '{"number":null,"displayName":null,"type":"Inventory","itemCategoryId":"00000000-0000-0000-0000-000000000000","itemCategorycode":"","blocked":false,"baseUnitOfMeasureId":"902d1241-2906-f011-9346-000d3ac96156","gtin":"","unitPrice":999,"priceIncludesTax":false,"unitCost":50,"taxGroupId":"00000000-0000-0000-0000-000000000000","taxGroupcode":""}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

import requests

url = "https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(2a2dfc50-f21b-4ab0-8f89-463efd0dfce4)/items(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)"

payload = {
  "number": None,
  "displayName": None,
  "type": "Inventory",
  "itemCategoryId": "00000000-0000-0000-0000-000000000000",
  "itemCategorycode": "",
  "blocked": False,
  "baseUnitOfMeasureId": "902d1241-2906-f011-9346-000d3ac96156",
  "gtin": "",
  "unitPrice": 999,
  "priceIncludesTax": False,
  "unitCost": 50,
  "taxGroupId": "00000000-0000-0000-0000-000000000000",
  "taxGroupcode": ""
}
headers = {
  "Content-Type": "application/json",
  "If-Match": "true",
  "Authorization": "Bearer <YOUR_TOKEN_HERE>"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.json())

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"number\": null,\n  \"displayName\": null,\n  \"type\": \"Inventory\",\n  \"itemCategoryId\": \"00000000-0000-0000-0000-000000000000\",\n  \"itemCategorycode\": \"\",\n  \"blocked\": false,\n  \"baseUnitOfMeasureId\": \"902d1241-2906-f011-9346-000d3ac96156\",\n  \"gtin\": \"\",\n  \"unitPrice\": 999,\n  \"priceIncludesTax\": false,\n  \"unitCost\": 50,\n  \"taxGroupId\": \"00000000-0000-0000-0000-000000000000\",\n  \"taxGroupcode\": \"\"\n}");
Request request = new Request.Builder()
  .url("https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(2a2dfc50-f21b-4ab0-8f89-463efd0dfce4)/items(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)")
  .patch(body)
  .addHeader("Content-Type", "application/json")
  .addHeader("If-Match", "true")
  .addHeader("Authorization", "Bearer <YOUR_TOKEN_HERE>")
  .build();

Response response = client.newCall(request).execute();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(2a2dfc50-f21b-4ab0-8f89-463efd0dfce4)/items(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)"),
  Headers =
  {
    { "If-Match", "true" },
    { "Authorization", "Bearer <YOUR_TOKEN_HERE>" },
  },
  Content = new StringContent("{\n  \"number\": null,\n  \"displayName\": null,\n  \"type\": \"Inventory\",\n  \"itemCategoryId\": \"00000000-0000-0000-0000-000000000000\",\n  \"itemCategorycode\": \"\",\n  \"blocked\": false,\n  \"baseUnitOfMeasureId\": \"902d1241-2906-f011-9346-000d3ac96156\",\n  \"gtin\": \"\",\n  \"unitPrice\": 999,\n  \"priceIncludesTax\": false,\n  \"unitCost\": 50,\n  \"taxGroupId\": \"00000000-0000-0000-0000-000000000000\",\n  \"taxGroupcode\": \"\"\n}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(2a2dfc50-f21b-4ab0-8f89-463efd0dfce4)/items(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'number' => null,
    'displayName' => null,
    'type' => 'Inventory',
    'itemCategoryId' => '00000000-0000-0000-0000-000000000000',
    'itemCategorycode' => '',
    'blocked' => null,
    'baseUnitOfMeasureId' => '902d1241-2906-f011-9346-000d3ac96156',
    'gtin' => '',
    'unitPrice' => 999,
    'priceIncludesTax' => null,
    'unitCost' => 50,
    'taxGroupId' => '00000000-0000-0000-0000-000000000000',
    'taxGroupcode' => ''
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <YOUR_TOKEN_HERE>",
    "Content-Type: application/json",
    "If-Match: true"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(2a2dfc50-f21b-4ab0-8f89-463efd0dfce4)/items(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)"

	payload := strings.NewReader("{\n  \"number\": null,\n  \"displayName\": null,\n  \"type\": \"Inventory\",\n  \"itemCategoryId\": \"00000000-0000-0000-0000-000000000000\",\n  \"itemCategorycode\": \"\",\n  \"blocked\": false,\n  \"baseUnitOfMeasureId\": \"902d1241-2906-f011-9346-000d3ac96156\",\n  \"gtin\": \"\",\n  \"unitPrice\": 999,\n  \"priceIncludesTax\": false,\n  \"unitCost\": 50,\n  \"taxGroupId\": \"00000000-0000-0000-0000-000000000000\",\n  \"taxGroupcode\": \"\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("If-Match", "true")
	req.Header.Add("Authorization", "Bearer <YOUR_TOKEN_HERE>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Response

application/json

{
  "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "number": null,
  "displayName": null,
  "type": null,
  "itemCategoryId": null,
  "itemCategoryCode": null,
  "blocked": null,
  "baseUnitOfMeasureId": null,
  "baseUnitOfMeasure": {
    "code": null,
    "displayName": null,
    "symbol": null,
    "unitConversion": {
      "toUnitOfMeasure": null,
      "fromToConversionRate": null,
      "picture": [
        null
      ],
      "defaultDimensions": [
        null
      ],
      "itemCategory": {}
    },
    "picture": [
      {}
    ],
    "defaultDimensions": [
      {}
    ],
    "itemCategory": {
      "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
      "code": "I2K5893",
      "displayName": null,
      "lastModifiedDateTime": null
    }
  },
  "gtin": null,
  "inventory": null,
  "unitPrice": null,
  "priceIncludesTax": null,
  "unitCost": null,
  "taxGroupId": null,
  "taxGroupCode": null,
  "lastModifiedDateTime": null,
  "picture": [
    {
      "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
      "width": null,
      "height": null,
      "contentType": null,
      "content@odata.mediaEditLink": null,
      "content@odata.mediaReadLink": null
    }
  ],
  "defaultDimensions": [
    {
      "parentId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
      "dimensionId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
      "dimensionCode": null,
      "dimensionValueId": null,
      "dimensionValueCode": null,
      "postingValidation": null,
      "account": {},
      "dimension": {
        "dimensionValues": []
      },
      "dimensionValue": {}
    }
  ],
  "itemCategory": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": "I2K5893",
    "displayName": null,
    "lastModifiedDateTime": null
  }
}

Updates an object of type item in Dynamics 365 Business Central

Request

Security

Path

Headers

Body application/json required

Responses200

Body application/json

Responses