Updates the list of human-readable descriptive text strings associated with a dimension.
This is a privileged operation.
(Note: Concurrent requests to update a label or group of labels may result in data
being overwritten.)
Example
- update labels for a dimension referenced by ID
Request:
[
{
"locale" :"en-GB",
"value" :"grey"
}
]
Response:
HTTP/1.1
204
NO CONTENT
Example
- update labels for a dimension referenced by name
Request:
[
{
"locale" :"en-US",
"value" :"Metropolises"
},
{
"locale" :"es",
"value" :"metrĂ³polis"
},
{
"locale" :"es-ES",
"value" :"metrĂ³polis"
}
]
Response:
HTTP/1.1
204
NO CONTENT
Error
Example
- blank or missing new labels
Request:
[
{ "locale": "en" },
{ "locale": "en-US", "value": " " }
]
Response:
HTTP/1.1
400
BAD REQUEST
{
"errorID" : "DIM-001503",
"errorMessage": "Sorry, could not save the labels because there were errors.",
"requestID" : "DIM-0800200c9a66",
"details" :
[
{
"errorID" : "DIM-001501",
"errorMessage": "Sorry, label values must not be missing or blank.",
"locale" : "en"
},
{
"errorID" : "DIM-001501",
"errorMessage": "Sorry, label values must not be missing or blank.",
"locale" : "en-US"
},
]
}
Error
Example
- missing request payload
Request:
Response:
HTTP/1.1
400
BAD REQUEST