io7m | single-page | multi-page | epub | Looseleaf User Manual
8.2. /v1/rud
Previous
8. Protocol V1
Up
8.4. /v1/update
Next

# 8.3. /v1/read

- 8.3.1. Name
- 8.3.2. Description
- 8.3.3. Examples

## 8.3.1. Name

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

## 8.3.2. Description

1
The /v1/read endpoint is a convenience endpoint that directly returns the value of a key, assuming the key exists. It is equivalent to calling the /v1/rud endpoint with empty update and delete sets, and a read set that contains a single key, and then extracting the key value from the resulting values property and returning it directly. The endpoint is suffixed with the name of the target key, so to read key /x/y/z, the endpoint is called as /v1/read/x/y/z. The content type of the returned data is text/plain.

## 8.3.3. Examples

1
The following command reads the value of /x/y/z:

### 8.3.3.2. Example Read

    $ curl -u grouch:12345678 http://localhost:20000/v1/read/x/y/z
    /x/y/z

8.2. /v1/rud
Previous
8. Protocol V1
Up
8.4. /v1/update
Next
io7m | single-page | multi-page | epub | Looseleaf User Manual