curl --request PUT \
--url https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id} \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"userDefinedId": "<string>",
"userDefinedId2": "<string>",
"colorReference": "<string>",
"colorNote": "<string>",
"colorGroupIds": [
123
],
"languageIds": [
123
]
}
'import requests
url = "https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}"
payload = {
"name": "<string>",
"userDefinedId": "<string>",
"userDefinedId2": "<string>",
"colorReference": "<string>",
"colorNote": "<string>",
"colorGroupIds": [123],
"languageIds": [123]
}
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
userDefinedId: '<string>',
userDefinedId2: '<string>',
colorReference: '<string>',
colorNote: '<string>',
colorGroupIds: [123],
languageIds: [123]
})
};
fetch('https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'userDefinedId' => '<string>',
'userDefinedId2' => '<string>',
'colorReference' => '<string>',
'colorNote' => '<string>',
'colorGroupIds' => [
123
],
'languageIds' => [
123
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"userDefinedId\": \"<string>\",\n \"userDefinedId2\": \"<string>\",\n \"colorReference\": \"<string>\",\n \"colorNote\": \"<string>\",\n \"colorGroupIds\": [\n 123\n ],\n \"languageIds\": [\n 123\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"userDefinedId\": \"<string>\",\n \"userDefinedId2\": \"<string>\",\n \"colorReference\": \"<string>\",\n \"colorNote\": \"<string>\",\n \"colorGroupIds\": [\n 123\n ],\n \"languageIds\": [\n 123\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"userDefinedId\": \"<string>\",\n \"userDefinedId2\": \"<string>\",\n \"colorReference\": \"<string>\",\n \"colorNote\": \"<string>\",\n \"colorGroupIds\": [\n 123\n ],\n \"languageIds\": [\n 123\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"code": "<string>",
"data": {
"id": 123,
"name": "<string>",
"userDefinedId": "<string>",
"userDefinedId2": "<string>",
"colorReference": "<string>",
"state": "active",
"colorNote": "<string>",
"colorGroups": [
{
"id": 123,
"name": "<string>",
"userDefinedId": "<string>",
"state": "active"
}
],
"languageNames": [
{
"languageId": 123,
"languageName": "<string>",
"languageCode": "<string>",
"colorName": "<string>"
}
],
"properties": [
"<string>"
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}Updates a single color by ID.
Updates a color owned by the current organization. PUT is a full replace: every field on the request body is written to the database verbatim. The id comes from the route; the body carries none (sending one is a 400). Required fields (name, state) must be present and non-null; missing or null returns 400. Nullable scalar fields (userDefinedId, userDefinedId2, colorReference, colorNote) clear the column when sent as null. Collections (‘colorGroupIds’, ‘languageIds’) are written verbatim: an explicit list replaces the association set, an empty array or an omitted/null field clears the set. Unknown colorGroupIds or languageIds are rejected per-id with field paths colorGroupIds[i] / languageIds[k]. Use PATCH for partial updates. languageIds requires the organization to have the MultipleLanguage module licensed and UseMultipleLanguages enabled in color settings. When that feature is off, a non-empty languageIds is rejected with 400 business_rule_error at field languageIds, and an empty or omitted languageIds leaves the existing language links unchanged. The per-(color, language) translated text is owned by a separate endpoint and is never set from this endpoint.
curl --request PUT \
--url https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id} \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"userDefinedId": "<string>",
"userDefinedId2": "<string>",
"colorReference": "<string>",
"colorNote": "<string>",
"colorGroupIds": [
123
],
"languageIds": [
123
]
}
'import requests
url = "https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}"
payload = {
"name": "<string>",
"userDefinedId": "<string>",
"userDefinedId2": "<string>",
"colorReference": "<string>",
"colorNote": "<string>",
"colorGroupIds": [123],
"languageIds": [123]
}
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
userDefinedId: '<string>',
userDefinedId2: '<string>',
colorReference: '<string>',
colorNote: '<string>',
colorGroupIds: [123],
languageIds: [123]
})
};
fetch('https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'userDefinedId' => '<string>',
'userDefinedId2' => '<string>',
'colorReference' => '<string>',
'colorNote' => '<string>',
'colorGroupIds' => [
123
],
'languageIds' => [
123
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"userDefinedId\": \"<string>\",\n \"userDefinedId2\": \"<string>\",\n \"colorReference\": \"<string>\",\n \"colorNote\": \"<string>\",\n \"colorGroupIds\": [\n 123\n ],\n \"languageIds\": [\n 123\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"userDefinedId\": \"<string>\",\n \"userDefinedId2\": \"<string>\",\n \"colorReference\": \"<string>\",\n \"colorNote\": \"<string>\",\n \"colorGroupIds\": [\n 123\n ],\n \"languageIds\": [\n 123\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/api/colors/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"userDefinedId\": \"<string>\",\n \"userDefinedId2\": \"<string>\",\n \"colorReference\": \"<string>\",\n \"colorNote\": \"<string>\",\n \"colorGroupIds\": [\n 123\n ],\n \"languageIds\": [\n 123\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"code": "<string>",
"data": {
"id": 123,
"name": "<string>",
"userDefinedId": "<string>",
"userDefinedId2": "<string>",
"colorReference": "<string>",
"state": "active",
"colorNote": "<string>",
"colorGroups": [
{
"id": 123,
"name": "<string>",
"userDefinedId": "<string>",
"state": "active"
}
],
"languageNames": [
{
"languageId": 123,
"languageName": "<string>",
"languageCode": "<string>",
"colorName": "<string>"
}
],
"properties": [
"<string>"
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}{
"status": "success",
"code": "<string>",
"error": {
"details": [
{
"type": "<string>",
"field": "<string>",
"value": "<string>"
}
]
}
}Headers
Path Parameters
Unique identifier of the color to update.
Body
Display name of the color. Required on a full replace and cannot be cleared.
Primary customer-defined identifier for the color. Send null to clear it.
Secondary customer-defined identifier for the color. Send null to clear it.
Reference code for the color, such as a Pantone code. Send null to clear it.
Lifecycle state of the color. Required on a full replace.
active, inactive, deleted Free-text note describing the color. Send null to clear it.
Color group memberships to write. A populated list replaces the set. This is a full replace, so an empty, null, or omitted list clears every membership.
Language links to write. Requires the multiple-language feature. With the feature on this is a full replace, so a populated list replaces the set and an empty, null, or omitted list clears every link. With the feature off a populated list is rejected and an empty, null, or omitted one leaves the existing links untouched.
Response
OK
The coarse outcome of the request, indicating whether it succeeded or failed.
success, error The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire.
The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value.
Show child attributes
Show child attributes