@shinyaz

AgentCore Memory CLI parameter names differ from the documentation schema

1 min read

While verifying AgentCore Memory streaming notifications, I hit several cases where CLI parameter names didn't match the documentation schema examples.

batch-update-memory-records fails with ParamValidation if you omit the timestamp field. The docs schema doesn't explicitly mark it as required, but the CLI does.

Error message
Missing required parameter in records[0]: "timestamp"

The --memory-strategies key names are also tricky. The docs use semanticMemory conceptually, but the CLI expects semanticMemoryStrategy. Similarly, namespaceConfiguration should be namespaceTemplates, and the template syntax is {actorId} not {{actorId}}. The error messages helpfully list the valid key names, so the fastest approach is to try and read the error.

Error message (key name)
Unknown parameter in memoryStrategies[0]: "semanticMemory",
must be one of: semanticMemoryStrategy, summaryMemoryStrategy,
userPreferenceMemoryStrategy, customMemoryStrategy, episodicMemoryStrategy

Share this post

Shinya Tahara

Shinya Tahara

Solutions Architect @ AWS

I'm a Solutions Architect at AWS, providing technical guidance primarily to financial industry customers. I share learnings about cloud architecture and AI/ML on this site.The views and opinions expressed on this site are my own and do not represent the official positions of my employer.