Get 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.retrieve(
  '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.retrieve(
    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.Get(
		context.TODO(),
		"memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
		"mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
		cadenya.MemoryLayerEntryGetParams{
			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.retrieve(
  "memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
  "mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
  workspace_id: "workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
)

puts(memory_entry_detail)

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

<?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 => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

HttpResponse<String> response = Unirest.get("https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}")
  .header("Authorization", "Bearer <token>")
  .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>"
    }
  ]
}

GET

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.retrieve(
  '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.retrieve(
    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.Get(
		context.TODO(),
		"memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
		"mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
		cadenya.MemoryLayerEntryGetParams{
			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.retrieve(
  "memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
  "mementry_01HXKD2E5NQM3T9AYWCF5E52Z0",
  workspace_id: "workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
)

puts(memory_entry_detail)

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

<?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 => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

HttpResponse<String> response = Unirest.get("https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}")
  .header("Authorization", "Bearer <token>")
  .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>"
    }
  ]
}

Read one memory entry, and unlike listing them, this returns the content.

const entry = await client.memoryLayers.entries.retrieve(memoryLayerId, entryId, { workspaceId });

console.log(entry.content);          // 'Refunds within 30 days...'
console.log(entry.spec.key);         // 'policies/us/refunds'
console.log(entry.spec.description); // 'US refund window'

entry, err := client.MemoryLayers.Entries.Get(ctx, memoryLayerID, entryID,
	cadenya.MemoryLayerEntryGetParams{
		WorkspaceID: cadenya.String(workspaceID),
	})

fmt.Println(entry.Content)          // 'Refunds within 30 days...'
fmt.Println(entry.Spec.Key)         // 'policies/us/refunds'
fmt.Println(entry.Spec.Description) // 'US refund window'

entry = cadenya.memory_layers.entries.retrieve(memory_layer_id, entry_id, workspace_id: workspace_id)

puts entry.content          # 'Refunds within 30 days...'
puts entry.spec.key         # 'policies/us/refunds'
puts entry.spec.description # 'US refund window'

curl "https://api.cadenya.com/v1/workspaces/${WORKSPACE_ID}/memory_layers/${MEMORY_LAYER_ID}/entries/${ENTRY_ID}" \
  -H "Authorization: Bearer ${CADENYA_API_KEY}"

`content` is top-level, not under `spec`

The body sits beside spec, not inside it. spec holds key and description; content is its own field on the response.

Object.keys(entry);  // ['metadata', 'spec', 'info', 'content']

This is the only endpoint that hands content back. The list leaves it out so paging a big layer stays cheap, so fetch a single entry when you need its body. A missing ID is a 404.

The agent reads it differently

content here is for you. The agent never calls this endpoint; it reads the same entry through get_memory, resolved against the cascade by key. If the entry has expired (its layer or its own TTL), get_memory filters it out, but this endpoint still returns the row while it exists. info.memoryLayer names the layer the entry belongs to, and info.createdBy the profile that wrote it.

List memory entries

Every entry’s key and description, without the bodies.

Create a memory entry

Where content is written, and why reads redact it elsewhere.

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"

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

​content is top-level, not under spec

​The agent reads it differently

​Related

List memory entries

Create a memory entry

Memory layers

Authorizations

Path Parameters

Response

`content` is top-level, not under `spec`

The agent reads it differently

Related