Updates an object of type defaultDimensions 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: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
vendor_idstring (uuid)required
(v1.0) id for vendor

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
defaultDimensions_parentIdstring (uuid)required
(v1.0) parentId for defaultDimensions

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
defaultDimensions_dimensionIdstring (uuid)required
(v1.0) dimensionId for defaultDimensions

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

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

Responses

(v1.0) Succesfully updated the specifieddefaultDimensions

Body application/json

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

patch /companies({company_id})/vendors({vendor_id})/defaultDimensions({defaultDimensions_parentId},{defaultDimensions_dimensionId})

curl -X PATCH \
  'https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,e942a270-62d2-4aef-aa48-6fe3ef9e53e1)' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'If-Match: true' \
  -d '{
  "parentId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensionId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensioncode": null,
  "dimensionValueId": null,
  "dimensionValuecode": null,
  "postingValidation": null
}'

const url = 'https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,e942a270-62d2-4aef-aa48-6fe3ef9e53e1)';
const options = {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'If-Match': 'true',
    Authorization: 'Bearer <YOUR_TOKEN_HERE>'
  },
  body: '{"parentId":"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4","dimensionId":"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4","dimensioncode":null,"dimensionValueId":null,"dimensionValuecode":null,"postingValidation":null}'
};

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(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,e942a270-62d2-4aef-aa48-6fe3ef9e53e1)';
const options = {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'If-Match': 'true',
    Authorization: 'Bearer <YOUR_TOKEN_HERE>'
  },
  body: '{"parentId":"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4","dimensionId":"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4","dimensioncode":null,"dimensionValueId":null,"dimensionValuecode":null,"postingValidation":null}'
};

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(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,e942a270-62d2-4aef-aa48-6fe3ef9e53e1)"

payload = {
  "parentId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensionId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensioncode": None,
  "dimensionValueId": None,
  "dimensionValuecode": None,
  "postingValidation": None
}
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  \"parentId\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"dimensionId\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"dimensioncode\": null,\n  \"dimensionValueId\": null,\n  \"dimensionValuecode\": null,\n  \"postingValidation\": null\n}");
Request request = new Request.Builder()
  .url("https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,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(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,e942a270-62d2-4aef-aa48-6fe3ef9e53e1)"),
  Headers =
  {
    { "If-Match", "true" },
    { "Authorization", "Bearer <YOUR_TOKEN_HERE>" },
  },
  Content = new StringContent("{\n  \"parentId\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"dimensionId\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"dimensioncode\": null,\n  \"dimensionValueId\": null,\n  \"dimensionValuecode\": null,\n  \"postingValidation\": null\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(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,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([
    'parentId' => '2a2dfc50-f21b-4ab0-8f89-463efd0dfce4',
    'dimensionId' => '2a2dfc50-f21b-4ab0-8f89-463efd0dfce4',
    'dimensioncode' => null,
    'dimensionValueId' => null,
    'dimensionValuecode' => null,
    'postingValidation' => null
  ]),
  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(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,e942a270-62d2-4aef-aa48-6fe3ef9e53e1)"

	payload := strings.NewReader("{\n  \"parentId\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"dimensionId\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"dimensioncode\": null,\n  \"dimensionValueId\": null,\n  \"dimensionValuecode\": null,\n  \"postingValidation\": null\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

{
  "parentId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensionId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensionCode": null,
  "dimensionValueId": null,
  "dimensionValueCode": null,
  "postingValidation": null,
  "account": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "number": null,
    "displayName": null,
    "category": null,
    "subCategory": null,
    "blocked": null,
    "lastModifiedDateTime": null
  },
  "dimension": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": null,
    "displayName": null,
    "lastModifiedDateTime": null,
    "dimensionValues": [
      {}
    ]
  },
  "dimensionValue": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": null,
    "displayName": null,
    "lastModifiedDateTime": null
  }
}

Updates an object of type defaultDimensions in Dynamics 365 Business Central

Request

Security

Path

Headers

Body application/json required

Responses200

Body application/json

Responses