---
title: "POST /v1/{+parent}/memories:purge"
method: POST
path: "/v1/{+parent}/memories:purge"
tags: ["projects"]
---

# POST /v1/{+parent}/memories:purge

`POST /v1/{+parent}/memories:purge`

Purge memories.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudAiplatformV1PurgeMemoriesRequest — Request message for MemoryBankService.PurgeMemories.
  - `force` boolean — Optional. If true, the memories will actually be purged. If false, the purge request will be validated but not executed.
  - `filterGroups` GoogleCloudAiplatformV1MemoryConjunctionFilter[] — Optional. Metadata filters that will be applied to the memories to be purged. Filters are defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: [{key: "author", value: {string_value: "agent 123"}, op: EQUAL}]}, {filters: [{key: "label", value: {string_value: "travel"}, op: EQUAL}, {key: "author", value: {string_value: "agent 321"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = "agent 123" OR (metadata.label = "travel" AND metadata.author = "agent 321"))`.
    - `filters` GoogleCloudAiplatformV1MemoryFilter[] — Represents filters that will be combined using AND logic.
      - `key` string — Represents the key of the filter. For example, "author" would apply to `metadata` entries with the key "author".
      - `value` GoogleCloudAiplatformV1MemoryMetadataValue — Memory metadata.
        - `stringValue` string — Represents a string value.
        - `timestampValue` string, google-datetime — Represents a timestamp value. When filtering on timestamp values, only the seconds field will be compared.
        - `doubleValue` number, double — Represents a double value.
        - `boolValue` boolean — Represents a boolean value.
      - `op` 'OPERATOR_UNSPECIFIED' | 'EQUAL' | 'GREATER_THAN' | 'LESS_THAN' — Represents the operator to apply to the filter. If not set, then EQUAL will be used.
      - `negate` boolean — Indicates whether the filter will be negated.
  - `filter` string — Required. The standard list filter to determine which memories to purge. More detail in [AIP-160](https://google.aip.dev/160).

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/aiplatform.md) · [All operations](https://skmtc.net/google/apis/aiplatform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/aiplatform/versions/b608d71b91f0/schema)