# update_memory
Source:
PATCH
/v1/memories/{memory\_id}
Select code samplecURL (shell:curl)
```js
const url = 'https://app.everruns.com/api/v1/memories/example';
const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: '{"description":"example","name":"design-docs","source":{"branch":"main","repository":"acme/design-docs","root_folder":"docs/","type":"github"}}'
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
```
```sh
curl --request PATCH \
--url https://app.everruns.com/api/v1/memories/example \
--header 'Content-Type: application/json' \
--data '{ "description": "example", "name": "design-docs", "source": { "branch": "main", "repository": "acme/design-docs", "root_folder": "docs/", "type": "github" } }'
```
* Production APIapp.everruns.com/api/v1/memories/{memory\_id}
Update a workspace memory. Only provided fields are modified.
## Parameters
### Path Parameters
**memory\_id**
required
string
Memory ID
## Request Bodyrequired
Media typeapplication/json
Request body for the `update_memory` operation.
object
**description**
Human-readable description. Safe to render in user-facing messages.
string | null
**name**
Human-readable name. Safe to render in user-facing messages.
string | null
##### Example
```plaintext
design-docs
```
**source**
One of:
* object
One of:
* object
Source configuration. Example shape is defined on `CreateMemorySourceRequest`.
object
**branch**
Branch to sync. Defaults to the repository’s default branch when omitted.
string | null
##### Example
```plaintext
main
```
**repository**
required
GitHub repository in `owner/repo` form.
string
##### Example
```plaintext
acme/design-docs
```
**root\_folder**
Sub-directory within the repository to sync. Empty / omitted = whole tree.
string | null
##### Example
```plaintext
docs/
```
**sync\_interval\_secs**
Automatic resync interval in seconds. Omit or set 0 for manual-only; scheduled sync accepts 300 through 604800.
integer | null format: int32
<= 604800
##### Example
```json
3600
```
**type**
required
string
Allowed values: github
##### Example
```json
{
"branch": "main",
"repository": "acme/design-docs",
"root_folder": "docs/",
"type": "github"
}
```
* object
Source configuration. Example shape is defined on `CreateMemorySourceRequest`.
object
**branch**
Branch to sync. Defaults to the repository’s default branch when omitted.
string | null
##### Example
```plaintext
main
```
**root\_folder**
Sub-directory within the repository to sync. Empty / omitted = whole tree.
string | null
##### Example
```plaintext
docs/
```
**sync\_interval\_secs**
Automatic resync interval in seconds. Omit or set 0 for manual-only; scheduled sync accepts 300 through 604800.
integer | null format: int32
<= 604800
##### Example
```json
3600
```
**url**
required
Clonable git URL (SSH or HTTPS).
string
##### Example
```plaintext
https://github.com/acme/design-docs.git
```
**type**
required
string
Allowed values: git
##### Example
```json
{
"branch": "main",
"repository": "acme/design-docs",
"root_folder": "docs/",
"type": "github"
}
```
* null
Source configuration. Example shape is defined on `CreateMemorySourceRequest`.
object
**branch**
Branch to sync. Defaults to the repository’s default branch when omitted.
string | null
##### Example
```plaintext
main
```
**repository**
required
GitHub repository in `owner/repo` form.
string
##### Example
```plaintext
acme/design-docs
```
**root\_folder**
Sub-directory within the repository to sync. Empty / omitted = whole tree.
string | null
##### Example
```plaintext
docs/
```
**sync\_interval\_secs**
Automatic resync interval in seconds. Omit or set 0 for manual-only; scheduled sync accepts 300 through 604800.
integer | null format: int32
<= 604800
##### Example
```json
3600
```
**type**
required
string
Allowed values: github
##### Example
```json
{
"branch": "main",
"repository": "acme/design-docs",
"root_folder": "docs/",
"type": "github"
}
```
* object
Source configuration. Example shape is defined on `CreateMemorySourceRequest`.
object
**branch**
Branch to sync. Defaults to the repository’s default branch when omitted.
string | null
##### Example
```plaintext
main
```
**root\_folder**
Sub-directory within the repository to sync. Empty / omitted = whole tree.
string | null
##### Example
```plaintext
docs/
```
**sync\_interval\_secs**
Automatic resync interval in seconds. Omit or set 0 for manual-only; scheduled sync accepts 300 through 604800.
integer | null format: int32
<= 604800
##### Example
```json
3600
```
**url**
required
Clonable git URL (SSH or HTTPS).
string
##### Example
```plaintext
https://github.com/acme/design-docs.git
```
**type**
required
string
Allowed values: git
##### Example
```json
{
"branch": "main",
"repository": "acme/design-docs",
"root_folder": "docs/",
"type": "github"
}
```
* object
null
## Responses
### 200
Memory updated
Media typeapplication/json
Response body for memory.
object
**archived\_at**
Timestamp when this resource was archived, if any (RFC 3339).
string | null format: date-time
**created\_at**
required
Timestamp when this resource was created (RFC 3339).
string format: date-time
**deleted\_at**
Timestamp when this resource was soft-deleted, if any (RFC 3339).
string | null format: date-time
**description**
Human-readable description. Safe to render in user-facing messages.
string | null
**id**
required
Prefixed public identifier. See [ID Schema](https://everruns.com/docs/advanced/id-schema/).
string
**is\_readonly**
required
Whether the memory is mounted read-only into sessions. Read-only memories accept no writes from the session sandbox.
boolean
**last\_sync\_error**
Most recent sync error message; cleared on the next successful sync.
string | null
**last\_synced\_at**
Timestamp of the most recent successful sync (RFC 3339). `None` if never synced.
string | null format: date-time
**name**
required
Human-readable name. Safe to render in user-facing messages.
string
**owner\_agent\_id**
Owning agent when `scope = agent`.
string | null
**owner\_user\_id**
Owning user when `scope = user`.
string | null format: uuid
**scope**
required
Ownership scope (`org`, `agent`, or `user`).
string
**source**
required
One of:
* object
Source-specific configuration (git remote, github repo, manual upload).
object
**provider**
required
string
Allowed values: manual
* object
Source-specific configuration (git remote, github repo, manual upload).
object
**branch**
required
string
**repository**
required
string
**root\_folder**
string | null
**sync\_interval\_secs**
Automatic resync interval in seconds. Omit or set 0 for manual-only; scheduled sync accepts 300 through 604800.
integer | null format: int32
<= 604800
**provider**
required
string
Allowed values: github
* object
Source-specific configuration (git remote, github repo, manual upload).
object
**branch**
required
string
**root\_folder**
string | null
**sync\_interval\_secs**
Automatic resync interval in seconds. Omit or set 0 for manual-only; scheduled sync accepts 300 through 604800.
integer | null format: int32
<= 604800
**url**
required
string
**provider**
required
string
Allowed values: git
**source\_type**
required
Source kind discriminator (`manual`, `git`, `github`). Determines which `source` variant is populated.
string
**status**
required
Current lifecycle status.
string
**sync\_status**
required
Current sync status (`idle`, `syncing`, `succeeded`, `failed`). Only meaningful when `source_type` is `git` or `github`.
string
**updated\_at**
required
Timestamp when this resource was last updated (RFC 3339).
string format: date-time
##### Example
```json
{
"archived_at": "2026-05-26T00:00:00Z",
"created_at": "2026-04-01T10:00:00Z",
"deleted_at": "2026-05-26T00:00:00Z",
"description": "Living design documents synced from GitHub",
"id": "mem_01933b5a000070008000000000000001",
"is_readonly": false,
"last_sync_error": "ssh: connect to host github.com port 22: Connection timed out",
"last_synced_at": "2026-05-25T08:00:00Z",
"name": "design-docs",
"owner_agent_id": "agent_01933b5a000070008000000000000001",
"scope": "org",
"source": {
"provider": "manual"
},
"source_type": "github",
"status": "active",
"sync_status": "succeeded",
"updated_at": "2026-05-25T08:00:00Z"
}
```
### 400
Invalid input
Media typeapplication/json
Standard error response.
Wire shape is [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457): every error response includes `title` and `status`, and may include `detail`, `code`, `allowed_actions`, `retry_after_seconds`, `instance`, and `type`. The content type is rewritten to `application/problem+json` with the `application/problem+json` content type.
object
**allowed\_actions**
Recovery actions the caller can take next.
Array\