> IronFlow documentation for v1.20.0. [HTML version](https://ironflow.work/docs/nodes/s3vector_delete_vectors) · [Release source](https://github.com/skitsanos/ironflow/blob/v1.20.0/docs/nodes/s3vector_delete_vectors.md)

# `s3vector_delete_vectors`

Delete vectors by keys from an Amazon S3 Vector index.

For complete teardown, run this node before `s3vector_delete_index`, then run
`s3vector_delete_bucket` after every index in the bucket has been deleted.

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `vector_bucket_name` | string | yes* | -- | Explicit bucket name that owns a named index. |
| `bucket` | string | no | no | Alias for `vector_bucket_name`. |
| `index_name` | string | yes* | -- | Explicit target index name. |
| `index` | string | no | no | Alias for `index_name`. |
| `index_arn` | string | yes* | -- | Explicit self-contained alternative target. |
| `keys` | array<string> | yes | -- | Keys to delete from the index. |
| `keys_source_key` | string | no | -- | Context key containing string-array keys. |
| `region` | string | no | AWS region chain | Override `S3VECTORS_REGION`, `S3_REGION`, `AWS_REGION`, or `AWS_DEFAULT_REGION`. |
| `endpoint_url` | string | no | `AWS_ENDPOINT_URL` env var | Override the S3 Vectors service endpoint. |
| `output_key` | string | no | `s3vector` | Prefix for context output keys. |

## Target Resolution and Safety

Use exactly one explicit configured shape after interpolation:
`vector_bucket_name`/`bucket` plus `index_name`/`index`, or `index_arn` by
itself. Bucket ARN plus index name is not supported. Resource identifier
environment variables are deliberately never consulted for vector deletion;
region, endpoint, and AWS credentials may still come from the environment.
Conflicting forms and non-string, incomplete, or blank targets fail before the
AWS client is built.

## Context Output

- `{output_key}_deleted_count` — Number of keys submitted for deletion.
- `{output_key}_deleted_keys` — Key list.
- `{output_key}_success` — `true` on success.

## Example

```lua
local flow = Flow.new("s3vector_delete_vectors_example")

flow:step("delete_vectors", nodes.s3vector_delete_vectors({
    vector_bucket_name = "ironflow-vectors-demo",
    index_name = "ironflow-demo-index",
    keys = { "doc-1", "doc-2" },
    output_key = "delete"
}))

return flow
```