Update a memory entry

JavaScript

import Cadenya from '@cadenya/cadenya';

const client = new Cadenya({
  apiKey: process.env['CADENYA_API_KEY'], // This is the default and can be omitted
});

const memoryEntryDetail = await client.memoryLayers.entries.update(
  'memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH',
  'mementry_01HXKD2E5NQM3T9AYWCF5E52Z0',
  { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
);

console.log(memoryEntryDetail.content);

import os
from cadenya import Cadenya

client = Cadenya(
    api_key=os.environ.get("CADENYA_API_KEY"),  # This is the default and can be omitted
)
memory_entry_detail = client.memory_layers.entries.update(
    memory_layer_id="memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
    id="mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
    workspace_id="workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
)
print(memory_entry_detail.content)

package main

import (
	"context"
	"fmt"
	"go.cadenya.com/cadenya-go"
	"go.cadenya.com/cadenya-go/option"
)

func main() {
	client := cadenya.NewClient(
		option.WithAPIKey("My API Key"),
	)
	memoryEntryDetail, err := client.MemoryLayers.Entries.Update(
		context.TODO(),
		"memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
		"mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
		cadenya.MemoryLayerEntryUpdateParams{
			WorkspaceID: cadenya.String("workspace_01HXKD2E5NQM3T9AYWCF133E3Q"),
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", memoryEntryDetail.Content)
}

require "cadenya"

cadenya = Cadenya::Client.new(api_key: "My API Key")

memory_entry_detail = cadenya.memory_layers.entries.update(
  "memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
  "mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
  workspace_id: "workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
)

puts(memory_entry_detail)

cadenya memory-layers:entries update \
  --api-key 'My API Key' \
  --workspace-id workspace_01HXKD2E5NQM3T9AYWCF133E3Q \
  --memory-layer-id memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH \
  --id mementry_01HXKD2E5NQM3T9AYWCF5E52Z0

curl --request PATCH \
  --url https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "spec": {
    "key": "<string>",
    "description": "<string>",
    "content": "<string>",
    "uploadId": "upload_01HXKD2E5NQM3T9AYWCFZ05DNK"
  },
  "updateMask": "<string>"
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'spec' => [
        'key' => '<string>',
        'description' => '<string>',
        'content' => '<string>',
        'uploadId' => 'upload_01HXKD2E5NQM3T9AYWCFZ05DNK'
    ],
    'updateMask' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.patch("https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"spec\": {\n    \"key\": \"<string>\",\n    \"description\": \"<string>\",\n    \"content\": \"<string>\",\n    \"uploadId\": \"upload_01HXKD2E5NQM3T9AYWCFZ05DNK\"\n  },\n  \"updateMask\": \"<string>\"\n}")
  .asString();

{
  "metadata": {
    "id": "<string>",
    "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
    "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
    "name": "<string>",
    "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
    "createdAt": "2023-11-07T05:31:56Z",
    "externalId": "<string>",
    "labels": {},
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "spec": {
    "key": "<string>",
    "description": "<string>"
  },
  "content": "<string>",
  "info": {
    "memoryLayer": {
      "id": "<string>",
      "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
      "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
      "name": "<string>",
      "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
      "createdAt": "2023-11-07T05:31:56Z",
      "externalId": "<string>",
      "labels": {},
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "createdBy": {
      "metadata": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "name": "<string>",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "externalId": "<string>",
        "labels": {},
        "createdAt": "2023-11-07T05:31:56Z"
      },
      "spec": {
        "email": "<string>",
        "name": "<string>"
      }
    }
  }
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "<string>"
    }
  ]
}

PATCH

workspaces

{workspaceId}

memory_layers

{memoryLayerId}

entries

{id}

JavaScript

import Cadenya from '@cadenya/cadenya';

const client = new Cadenya({
  apiKey: process.env['CADENYA_API_KEY'], // This is the default and can be omitted
});

const memoryEntryDetail = await client.memoryLayers.entries.update(
  'memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH',
  'mementry_01HXKD2E5NQM3T9AYWCF5E52Z0',
  { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
);

console.log(memoryEntryDetail.content);

import os
from cadenya import Cadenya

client = Cadenya(
    api_key=os.environ.get("CADENYA_API_KEY"),  # This is the default and can be omitted
)
memory_entry_detail = client.memory_layers.entries.update(
    memory_layer_id="memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
    id="mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
    workspace_id="workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
)
print(memory_entry_detail.content)

package main

import (
	"context"
	"fmt"
	"go.cadenya.com/cadenya-go"
	"go.cadenya.com/cadenya-go/option"
)

func main() {
	client := cadenya.NewClient(
		option.WithAPIKey("My API Key"),
	)
	memoryEntryDetail, err := client.MemoryLayers.Entries.Update(
		context.TODO(),
		"memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
		"mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
		cadenya.MemoryLayerEntryUpdateParams{
			WorkspaceID: cadenya.String("workspace_01HXKD2E5NQM3T9AYWCF133E3Q"),
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", memoryEntryDetail.Content)
}

require "cadenya"

cadenya = Cadenya::Client.new(api_key: "My API Key")

memory_entry_detail = cadenya.memory_layers.entries.update(
  "memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
  "mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
  workspace_id: "workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
)

puts(memory_entry_detail)

cadenya memory-layers:entries update \
  --api-key 'My API Key' \
  --workspace-id workspace_01HXKD2E5NQM3T9AYWCF133E3Q \
  --memory-layer-id memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH \
  --id mementry_01HXKD2E5NQM3T9AYWCF5E52Z0

curl --request PATCH \
  --url https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "spec": {
    "key": "<string>",
    "description": "<string>",
    "content": "<string>",
    "uploadId": "upload_01HXKD2E5NQM3T9AYWCFZ05DNK"
  },
  "updateMask": "<string>"
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'spec' => [
        'key' => '<string>',
        'description' => '<string>',
        'content' => '<string>',
        'uploadId' => 'upload_01HXKD2E5NQM3T9AYWCFZ05DNK'
    ],
    'updateMask' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.patch("https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"spec\": {\n    \"key\": \"<string>\",\n    \"description\": \"<string>\",\n    \"content\": \"<string>\",\n    \"uploadId\": \"upload_01HXKD2E5NQM3T9AYWCFZ05DNK\"\n  },\n  \"updateMask\": \"<string>\"\n}")
  .asString();

{
  "metadata": {
    "id": "<string>",
    "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
    "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
    "name": "<string>",
    "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
    "createdAt": "2023-11-07T05:31:56Z",
    "externalId": "<string>",
    "labels": {},
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "spec": {
    "key": "<string>",
    "description": "<string>"
  },
  "content": "<string>",
  "info": {
    "memoryLayer": {
      "id": "<string>",
      "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
      "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
      "name": "<string>",
      "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
      "createdAt": "2023-11-07T05:31:56Z",
      "externalId": "<string>",
      "labels": {},
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "createdBy": {
      "metadata": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "name": "<string>",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "externalId": "<string>",
        "labels": {},
        "createdAt": "2023-11-07T05:31:56Z"
      },
      "spec": {
        "email": "<string>",
        "name": "<string>"
      }
    }
  }
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "<string>"
    }
  ]
}

Change a memory entry in place: rewrite its content, refine its description, or re-key it.

await client.memoryLayers.entries.update(memoryLayerId, entryId, {
  workspaceId,
  spec: { content: 'Refunds within 60 days now, up from 30.' },
});

_, err := client.MemoryLayers.Entries.Update(ctx, memoryLayerID, entryID,
	cadenya.MemoryLayerEntryUpdateParams{
		WorkspaceID: cadenya.String(workspaceID),
		Spec: cadenya.MemoryEntryUpdateSpecParam{
			Content: cadenya.String("Refunds within 60 days now, up from 30."),
		},
	})

cadenya.memory_layers.entries.update(
  memory_layer_id,
  entry_id,
  workspace_id: workspace_id,
  spec: {content: "Refunds within 60 days now, up from 30."}
)

curl -X PATCH "https://api.cadenya.com/v1/workspaces/${WORKSPACE_ID}/memory_layers/${MEMORY_LAYER_ID}/entries/${ENTRY_ID}" \
  -H "Authorization: Bearer ${CADENYA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"spec": {"content": "Refunds within 60 days now, up from 30."}}'

The key is mutable

The key is not a fixed identity, it is a field you can change like any other:

await client.memoryLayers.entries.update(memoryLayerId, entryId, {
  workspaceId,
  spec: { key: 'policy/refunds-2026' },
});

Re-keying matters because the key is how an agent loads the entry through get_memory and how the cascade resolves it. Change the key and any prompt or code that referenced the old one stops finding it. The entry keeps its mementry_... id across a re-key; only the lookup handle moves.

It merges

Send only what you are changing, and the rest survives. A content-only update leaves key and description intact, verified: patch only content and the entry keeps its key and description. One consequence of the merge: setting an optional field like description to an empty string reads as “no change”, not “clear it”, so the old value stays. Send the value you want rather than relying on an empty string to blank a field.

Create a memory entry

The key, description, and content fields you edit here.

Get a memory entry

Read back the content after an edit.

Memory layers

How the agent resolves a key through the cascade.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId

string

required

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

memoryLayerId

string

required

Memory layer ID. Accepts canonical memlyr_… form or external_id: form.

Example:

"memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH"

string

required

Example:

"mementry_01HXKD2E5NQM3T9AYWCF5E52Z0"

Body

application/json

metadata

object

UpdateResourceMetadata contains the user-provided fields for updating a workspace-scoped resource. Read-only fields (id, account_id, workspace_id, profile_id, created_at) are excluded since they are set by the server.

Show child attributes

spec

object

MemoryEntryUpdateSpec is the input shape for UpdateMemoryEntry. Fields present in the request's update_mask are applied; unset fields are left alone. The source oneof is optional for updates — omit it to leave the body untouched, or set exactly one branch to replace it.

Show child attributes

updateMask

string<field-mask>

Response

MemoryEntryDetail is the full representation of an entry, including the resolved content body. Returned by GetMemoryEntry, CreateMemoryEntry, and UpdateMemoryEntry.

metadata

object

required

Standard metadata for persistent, named resources (e.g., agents, tools, prompts)

Show child attributes

spec

object

required

MemoryEntrySpec is the metadata portion of an entry — the fields that identify and describe it, without the body. It appears on both the summary (MemoryEntry) and detail (MemoryEntryDetail) views.

Show child attributes

content

string

required

The resolved body of the entry. For entries created or updated via an upload_id, this is the ingested content, not the original upload handle. May be empty; an entry with only a key and description is valid (e.g., a stub skill being drafted, or an entry where the frontmatter alone is the payload).

info

object

Show child attributes

​The key is mutable

​It merges

​Related

Create a memory entry

Get a memory entry

Memory layers

Authorizations

Path Parameters

Body

Response

The key is mutable

It merges

Related