# tigris objects delete

Delete one or more objects by key from the given bucket. On a versioned bucket, the default creates a delete marker; use `--version-id` or `--all-versions` to hard-delete versions.

**Alias:** `d`

## Usage[​](#usage "Direct link to Usage")

```
tigris objects delete <bucket> <key> [flags]

t3 o d <bucket> <key> [flags]
```

## Flags[​](#flags "Direct link to Flags")

| Name             | Required | Default | Description                                                                                              |
| ---------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------- |
| `--version-id`   | No       | —       | Hard-delete a specific object version (requires bucket versioning). Targets a single key                 |
| `--all-versions` | No       | —       | Hard-delete every version and delete marker for the given key(s). Mutually exclusive with `--version-id` |
| `--yes`, `-y`    | No       | —       | Skip confirmation prompts                                                                                |

## Examples[​](#examples "Direct link to Examples")

```
# Delete a single object

tigris objects delete my-bucket old-file.txt



# Delete multiple objects

tigris objects delete my-bucket file-a.txt,file-b.txt



# On a versioned bucket: delete a specific version (hard delete)

tigris objects delete my-bucket old-file.txt --version-id abc123 --yes



# On a versioned bucket: nuke every version and delete marker for a key

tigris objects delete my-bucket old-file.txt --all-versions --yes
```
