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

# 8.5. /v1/delete

- 8.5.1. Name
- 8.5.2. Description
- 8.5.3. Examples

## 8.5.1. Name

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

## 8.5.2. Description

1
The /v1/delete 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 update and read sets, and a delete 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/delete/x/y/z.

## 8.5.3. Examples

1
The following command deletes the key /x/y/z:

### 8.5.3.2. Example Update

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

    $ curl -u grouch:12345678 http://localhost:20000/v1/get/x/y/z
    {"errors":[{"errorCode":"not-found","message":"Key not found: /x/y/z"}]}

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