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

# POST /v1/{+parent}/memories

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

Create a Memory.

## Path parameters

- `parent` string, required

## Query parameters

- `memoryId` string

## Request body

- GoogleCloudAiplatformV1Memory — A memory.
  - `expireTime` string, google-datetime — Optional. Represents the timestamp of when this resource is considered expired. This is *always* provided on output when `expiration` is set on input, regardless of whether `expire_time` or `ttl` was provided.
  - `updateTime` string, google-datetime — Output only. Represents the timestamp when this Memory was most recently updated.
  - `ttl` string, google-duration — Optional. Input only. Represents the TTL for this resource. The expiration time is computed: now + TTL.
  - `metadata` object — Optional. Represents user-provided metadata for the Memory. This information was provided when creating, updating, or generating the Memory. It was not generated by Memory Bank.
  - `disableMemoryRevisions` boolean — Optional. Input only. Indicates whether no revision will be created for this request.
  - `createTime` string, google-datetime — Output only. Represents the timestamp when this Memory was created.
  - `fact` string — Optional. Represents semantic knowledge extracted from the source content.
  - `revisionLabels` object — Optional. Input only. Represents the labels to apply to the Memory Revision created as a result of this request.
  - `revisionExpireTime` string, google-datetime — Optional. Input only. Represents the timestamp of when the revision is considered expired. If not set, the memory revision will be kept until manually deleted.
  - `topics` GoogleCloudAiplatformV1MemoryTopicId[] — Optional. Represents the Topics of the Memory.
    - `customMemoryTopicLabel` string — Optional. Represents the custom memory topic label.
    - `managedMemoryTopic` 'MANAGED_TOPIC_ENUM_UNSPECIFIED' | 'USER_PERSONAL_INFO' | 'USER_PREFERENCES' | 'KEY_CONVERSATION_DETAILS' | 'EXPLICIT_INSTRUCTIONS' — Optional. Represents the managed memory topic.
  - `revisionTtl` string, google-duration — Optional. Input only. Represents the TTL for the revision. The expiration time is computed: now + TTL.
  - `displayName` string — Optional. Represents the display name of the Memory.
  - `scope` object — Required. Immutable. Represents the scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'.
  - `name` string — Identifier. Represents the resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`
  - `description` string — Optional. Represents the description of the Memory.

## 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)