Sign in

v56

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01142337440.5 KB
MemoryService
Memory Entries

Create a new memory entry

Creates a new entry in a memory layer. Returns the detail view, including the resolved content body.

post/v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries

Path parameters

workspaceIdstring required
Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q
memoryLayerIdstring required
Example:memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH

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

Request body

workspaceIdstring
memoryLayerIdstring

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

Example request

{
  "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
  "memoryLayerId": "memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
  "spec": {
    "uploadId": "upload_01HXKD2E5NQM3T9AYWCFZ05DNK"
  }
}

Response

OK

contentstring 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).

Example response

{
  "metadata": {
    "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
    "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
    "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
  },
  "info": {
    "memoryLayer": {
      "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
      "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
      "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
    },
    "createdBy": {
      "metadata": {
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
      }
    }
  }
}