## List memory entries

`memory_layers.entries.list(memory_layer_id, **kwargs) -> CursorPagination<MemoryEntry>`

**get** `/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries`

Lists all entries in a memory layer

### Parameters

- `workspace_id: String`

- `memory_layer_id: String`

- `bundle_key: String`

  Filter by bundle_key — return only resources owned by this bundle.

- `cursor: String`

  Pagination cursor from previous response

- `include_info: bool`

  When set to true you may use more of your alloted API rate-limit

- `limit: Integer`

  Maximum number of results to return

- `prefix: String`

  Filter by key prefix (e.g., "skills/postmortem/" to list all entries
  under that hierarchy). Matches against the entry's key, not its name.

- `query: String`

  Free-form search query

- `sort_order: String`

  Sort order for results (asc or desc by creation time)

### Returns

- `class MemoryEntry`

  MemoryEntry is a single keyed value within a MemoryLayer. Entries are
  addressed by their key, which follows the S3 object key safe-character
  convention (see MemoryEntrySpec.key for the full rule). Keys are unique
  within a single layer; the same key may appear in multiple layers, in which
  case the LIFO stack-walk determines which one wins for a given objective.

  MemoryEntry is the summary shape, returned by ListMemoryEntries. It does
  not carry the entry body — callers that need the body must fetch the entry
  individually via GetMemoryEntry, which returns a MemoryEntryDetail.

  - `metadata: ResourceMetadata`

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

    - `id: String`

      Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...")

    - `account_id: String`

      Account this resource belongs to for multi-tenant isolation (prefixed ULID)

    - `created_at: Time`

      Timestamp when this resource was created

    - `name: String`

      Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool")
      Required for resources that users interact with directly

    - `profile_id: String`

      ID of the actor (user or service account) that created this resource

    - `workspace_id: String`

      Workspace this resource belongs to for organizational grouping (prefixed ULID)

    - `bundle_key: String`

      Optional bundle ownership key. When set, indicates the resource is
      managed by a configuration bundle identified by this key. Used by
      BulkWorkspaceResources.Apply to track which resources belong to which
      bundle for reconciliation / soft-delete on re-apply.

    - `external_id: String`

      External ID for the resource (e.g., a workflow ID from an external system)

    - `labels: Hash[Symbol, String]`

      Arbitrary key-value pairs for categorization and filtering
      Examples: {"environment": "production", "team": "platform", "version": "v2"}

  - `spec: MemoryEntrySpec`

    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.

    - `key: String`

      The lookup key for this entry within its layer. Must conform to the S3
      object key safe-characters spec: ASCII alphanumerics and the special
      characters !, -, _, ., *, ', (, ), and /. Forward slashes may be used to
      suggest hierarchy (e.g., "skills/postmortem/write"), but lookups are flat
      — the key is a single opaque string, not a path.

      Additional rules enforced by the service:

      - May not begin or end with /
      - May not contain consecutive slashes (//)
      - May not begin with reserved prefixes (cadenya/, system/)
      - Case-sensitive
      - Unique within the parent layer

      For skills entries, this key is also the id the model passes to
      memory_load_skill when it decides to load the entry's content.

    - `description: String`

      One-line "when to use this" hint shown in the frontmatter manifest for
      skills entries. The model uses this to decide whether to load the body,
      so it should be written for the model as the audience. Ignored for layer
      types that do not advertise frontmatter.

  - `info: MemoryEntryInfo`

    - `created_by: Profile`

      A profile identifies a user or non-human principal (such as an API key)
      at the account level. Profiles are account-scoped and can be granted access
      to multiple workspaces.

      - `metadata: AccountResourceMetadata`

        AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace.

        - `id: String`

          Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...")

        - `account_id: String`

          Account this resource belongs to for multi-tenant isolation (prefixed ULID)

        - `name: String`

          Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool")
          Required for resources that users interact with directly

        - `profile_id: String`

        - `external_id: String`

          External ID for the resource (e.g., a workflow ID from an external system)

        - `labels: Hash[Symbol, String]`

          Arbitrary key-value pairs for categorization and filtering
          Examples: {"environment": "production", "team": "platform", "version": "v2"}

      - `spec: ProfileSpec`

        Configuration for a profile.

        - `type: :PROFILE_TYPE_UNSPECIFIED | :PROFILE_TYPE_USER | :PROFILE_TYPE_API_KEY | :PROFILE_TYPE_SYSTEM`

          Whether this profile represents a human user, an API key, or a system
          principal.

          - `:PROFILE_TYPE_UNSPECIFIED`

          - `:PROFILE_TYPE_USER`

          - `:PROFILE_TYPE_API_KEY`

          - `:PROFILE_TYPE_SYSTEM`

        - `email: String`

          Email address of the profile. Required and unique within an account for
          user profiles.

        - `name: String`

          Display name (e.g., "Bobby Tables").

    - `memory_layer: ResourceMetadata`

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

### Example

```ruby
require "cadenya"

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

page = cadenya.memory_layers.entries.list("memoryLayerId", workspace_id: "workspaceId")

puts(page)
```

#### Response

```json
{
  "items": [
    {
      "metadata": {
        "id": "id",
        "accountId": "accountId",
        "createdAt": "2019-12-27T18:11:19.117Z",
        "name": "name",
        "profileId": "profileId",
        "workspaceId": "workspaceId",
        "bundleKey": "bundleKey",
        "externalId": "externalId",
        "labels": {
          "foo": "string"
        }
      },
      "spec": {
        "key": "key",
        "description": "description"
      },
      "info": {
        "createdBy": {
          "metadata": {
            "id": "id",
            "accountId": "accountId",
            "name": "name",
            "profileId": "profileId",
            "externalId": "externalId",
            "labels": {
              "foo": "string"
            }
          },
          "spec": {
            "type": "PROFILE_TYPE_UNSPECIFIED",
            "email": "email",
            "name": "name"
          }
        },
        "memoryLayer": {
          "id": "id",
          "accountId": "accountId",
          "createdAt": "2019-12-27T18:11:19.117Z",
          "name": "name",
          "profileId": "profileId",
          "workspaceId": "workspaceId",
          "bundleKey": "bundleKey",
          "externalId": "externalId",
          "labels": {
            "foo": "string"
          }
        }
      }
    }
  ],
  "pagination": {
    "nextCursor": "nextCursor",
    "total": 0
  }
}
```