---
title: "delete object · RUAL Documentation"
description: "Removes an object. Deleting a key that is not there is not an error."
canonical: https://docs.rual.nl/block-types/object%20storage/s3connection_delete_object
language: en
---

[Cluster](https://docs.rual.nl/cluster)

[Blocks](https://docs.rual.nl/block-types)

[Interfaces](https://docs.rual.nl/interfaces)

[Blueprints](https://docs.rual.nl/blueprints)

[Tutorials](https://docs.rual.nl/tutorials)

[Home automation](https://docs.rual.nl/home-automation)

[Examples](https://docs.rual.nl/examples)

[Reference](https://docs.rual.nl/reference)

[Architecture](https://docs.rual.nl/architecture)

[Troubleshooting](https://docs.rual.nl/troubleshooting)

Other

# delete object

This block is part of the [`object storage`](https://docs.rual.nl/block-types/object%20storage) group and was last modified in core [`v15.0.1`](https://docs.rual.nl/core-versions/150001).

Removes an object. Deleting a key that is not there is not an error.

- flow `flow`

- connection required `s3connection` The object storage connection to use, from an **open connection** block.

- bucket `value` Bucket name. Leave empty to use the bucket set on the connection.

- key required `value` The object key to delete.

- flow `flow`

- connection `s3connection` The same connection, so it can be passed to the next block.

- success `condition` True when the delete was accepted, including when the object was already gone.

- error `value`

- key `value` The key that was deleted.

Deletes `bucket`/`key`. IDEMPOTENT: S3 answers 204 for a key that does not exist, so this reports success=true whether or not anything was removed : a cleanup flow should not fail because it ran twice. It therefore cannot tell you whether the object existed; run s3connection_head_object first when that matters. success=false with NO_CONNECTION, MISSING_BUCKET, MISSING_KEY, or an S3 code such as AccessDenied.

| `s3 delete` |
| --- |
| `remove object` |
| `delete` |

## Version history

Introduced in [`v15.0.1`](https://docs.rual.nl/core-versions/150001).

- [Back to `object storage`](https://docs.rual.nl/block-types/object%20storage): Return to the main group to view all sub-groups

- [Back to `object storage`](https://docs.rual.nl/block-types/object%20storage?group=object%20storage): Return to the group to view all blocks within this group

Was this page helpful? [Tell us what to improve](https://docs.rual.nl/support) · RUAL Docs is an integral component of the [RUAL ecosystem](https://rual.nl)