patch
Overview
This endpoint is used for updating metadata on a variable.
HTTP Request
Note that you can only update metadata on a variable belonging to a table. You cannot edit metadata associated with a variable belonging to an upload (though this upload variable will always be represented by a corresponding table variable).
Path parameters
Parameter
tableReference
A qualified reference to the table. See referencing resources for more information.
variableName
The name of the variable (case insensitive)
This endpoint extends the general API structure
Request body
Provide a JSON object with the properties you would like to update. All fields are optional. To unset a value, specify null
for the given property.
label
string
A human-readable label for the variable. Must be less than or equal to 256 characters.
description
string
A longer description of the variable. Must be less than or equal to 5,000 characters.
valueLabels
array[object]
A mapping between values in the data and human readable labels. Passed as an array of objects, each with "value" and "label" properties. E.g.,
[{
"value": "1",
"label": "Yes"
},{
"value": "2"
"label": "No"
}]
.
The total length of all values + labels cannot exceed 1 million characters.
Passing an empty array will remove all value labels from the variable.
Authorization
Edit access to the corresponding dataset is required. Your access token must have the following scope:
data.edit
Learn more about authorization.
Response body
Returns the JSON-encoded "get" representation of a table resource.
Last updated