---
title: DeleteBuilder
summary: A builder for KVStore deletes, supporting advanced features like asynchronous execution.
url: https://www.fastly.com/documentation/reference/compute/sdks/rust/fastly/struct.DeleteBuilder/
---

**Kind:** Struct  
**Module:** [fastly](https://www.fastly.com/documentation/reference/compute/sdks/rust/fastly/)  
**Package:** fastly 0.13.1  
**Source:** https://docs.rs/crate/fastly/0.13.1/source/src/kv_store.rs#434

```rust
pub struct DeleteBuilder<'a> { /* private fields */ }
```

A builder for KVStore deletes, supporting advanced features like asynchronous execution.

```rust
store.build_delete()
   .execute("key1")?;
```

## Synchronous and Asynchronous support

DeleteBuilder exposes the ability to issue an asynchronous delete. Using
[`execute_async`](https://www.fastly.com/documentation/reference/compute/sdks/rust/fastly/kv_store/struct.DeleteBuilder/#method-execute_async) will send the request, and unblock. There is currently no polling mechanism.
To retrieve the result, use the blocking function [`pending_delete_wait`](https://www.fastly.com/documentation/reference/compute/sdks/rust/fastly/kv_store/struct.KVStore/#method-pending_delete_wait).

## Examples

```rust
// synchronous non-builder delete
let result: Result<(), KVStoreError> = store.delete("key");
// synchronous builder delete
let result: Result<(), KVStoreError> = store.build_delete().execute("key");
// asynchronous builder delete
let delete_handle: Result<PendingDeleteHandle, KVStoreError> = store.build_delete().execute_async("key");
let result: Result<(), KVStoreError> = store.pending_delete_wait(delete_handle?);
```

## Methods

### execute

**Source:** https://docs.rs/crate/fastly/0.13.1/source/src/kv_store.rs#442

```rust
fn execute(&self, key: &str) -> Result<(), KVStoreError>
```

Initiate and wait on an delete of a value in the KV Store.

Returns `Ok(()))` if the value is deleted without error, and `KVStoreError` if the delete failed.

**Parameters**

- `self`: `&Self`
- `key`: `&str`

**Returns**

`Result<(), KVStoreError>`

### execute_async

**Source:** https://docs.rs/crate/fastly/0.13.1/source/src/kv_store.rs#450

```rust
fn execute_async(&self, key: &str) -> Result<PendingDeleteHandle, KVStoreError>
```

Initiate async delete of a value in the KV Store.

Returns `Ok(PendingDeleteHandle)` if delete creation is successful.

**Parameters**

- `self`: `&Self`
- `key`: `&str`

**Returns**

`Result<PendingDeleteHandle, KVStoreError>`

## Auto trait implementations

- `Freeze`
- `RefUnwindSafe`
- `Send`
- `Sync`
- `Unpin`
- `UnsafeUnpin`
- `UnwindSafe`

## Blanket implementations

- `Any`
- `Borrow<T>`
- `BorrowMut<T>`
- `Downcast`
- `DowncastSync`
- `ErasedDestructor`
- `From<T>`
- `Into<U>`
- `IntoEither`
- `Same`
- `TryFrom<U>`
- `TryInto<U>`