io7m | single-page | multi-page | epub | Looseleaf User Manual
8.3. /v1/read
Previous
8. Protocol V1
Up
8.5. /v1/delete
Next

# 8.4. /v1/update

- 8.4.1. Name
- 8.4.2. Description
- 8.4.3. Examples

## 8.4.1. Name

1
/v1/update - Directly update the value of a single key

## 8.4.2. Description

1
The /v1/update endpoint is a convenience endpoint that directly updates the value of a key, assuming the key exists. It is equivalent to calling the /v1/rud endpoint with empty read and delete sets, and an update set that contains a single key. The endpoint is suffixed with the name of the target key, so to update key /x/y/z, the endpoint is called as /v1/update/x/y/z.

## 8.4.3. Examples

1
The following command updates the value of /x/y/z to "a new value":

### 8.4.3.2. Example Update

    $ curl -u grouch:12345678 -d 'a new value' http://localhost:20000/v1/update/x/y/z

    $ curl -u grouch:12345678 http://localhost:20000/v1/get/x/y/z
    a new value

8.3. /v1/read
Previous
8. Protocol V1
Up
8.5. /v1/delete
Next
io7m | single-page | multi-page | epub | Looseleaf User Manual