patch

Overview

This endpoint is used for updating metadata on a variable.

HTTP Request

PATCH /api/v1/tables/:tableReference/variables/:variableName

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.

Property nameTypeDescription

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

object

A mapping between values in the data and human readable labels. E.g., { 1: "yes", 2: "no", "NA": "no answer" }. Total length of all keys + values cannot exceed 1 million characters.

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