# Propose a memory change

> File a note for the memory agent to fold in on its next run. Does not edit memory.

Source: https://docs.generalinput.com/api/memory/propose



<Endpoint method="POST" path="/v1/memory/:ownerType/proposals" />

<Access scope="memory:manage" />

Phrase the note as the change to make ("deploys go out Tuesdays"), not a summary of a conversation. Workspace memory is shared with the whole team, so keep it about the business, never about a person; anything personal goes to `membership`.

## Path and query [#path-and-query]

As for [read memory](/api/memory/get).

## Body [#body]

| Field  | Type   | Required | Notes                              |
| ------ | ------ | -------- | ---------------------------------- |
| `note` | string | yes      | The change, up to 1000 characters. |

## Response [#response]

```json
{ "message": "Queued for the next memory update." }
```

## Errors [#errors]

| Status | When                                                                        |
| ------ | --------------------------------------------------------------------------- |
| `400`  | The note is empty, too long, or the queue refused it. The message says why. |
| `403`  | The member may not modify that memory.                                      |