Skip to main content
curl -X POST https://api.usenaive.ai/v1/memory \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Our primary domain is example.com, brand color #FF6B00",
    "target": "memory"
  }'

{
  "status": "memory_requested",
  "run": {
    "run_id": "run-abc-123"
  }
}

​
Request Body

FieldTypeRequiredDescription
contentstringYesThe knowledge to store
targetstringNomemory (agent facts, default) or user (user preferences)
agent_idstringNoSpecific agent to store memory for (default: CEO)

​
Behavior

Memory writes go through the CEO agent — Hermes owns MEMORY.md files in each profile. The CEO incorporates the content into its memory during its next turn. The sidecar then mirrors the updated file to the datastore for read access. Use GET /v1/memory after a few seconds to verify storage.