> ## Documentation Index
> Fetch the complete documentation index at: https://upstash.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete

The delete method allows you to delete documents from your index using various criteria. You can delete documents by their IDs, by ID prefix or with metadata filter.

## Arguments

<ResponseField name="IDs" type="string[] | number[] | string | number" required>
  One or more document IDs to delete.
</ResponseField>

**OR**

<ResponseField name="DeletePayload" type="object" required>
  <Expandable defaultOpen="true">
    <ResponseField name="ids" type="string[] | number[] | string | number">
      One or more document IDs to delete.
    </ResponseField>

    <ResponseField name="prefix" type="string">
      A string prefix to match document IDs for deletion. All documents with IDs starting with this prefix will be deleted.
    </ResponseField>

    <ResponseField name="filter" type="string">
      A [filter](/search/features/filtering) to delete documents based on content fields.

      <Warning>
        Deleting document with filter is a O(N) operation that performs a full
        scan. Therefore, it might be slow for large indexes.
      </Warning>
    </ResponseField>
  </Expandable>
</ResponseField>

## Response

<ResponseField name="Response" type="DeleteResult" required>
  <Expandable defaultOpen="true">
    <ResponseField name="deleted" type="number" required>
      The number of documents that were successfully deleted.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```typescript Delete by IDs Array theme={"system"}
  const response = await index.delete(["star-wars", "inception"]);
  // { deleted: 2 }
  ```

  ```typescript Delete Single ID theme={"system"}
  const response = await index.delete("star-wars");
  // { deleted: 1 }
  ```

  ```typescript Delete by Prefix theme={"system"}
  const response = await index.delete({
    prefix: "star-",
  });
  // { deleted: 3 }
  ```

  ```typescript Delete with Filter theme={"system"}
  const response = await index.delete({
    filter: "age > 30",
  });
  // { deleted: 3 }
  ```
</RequestExample>