メインコンテンツへスキップ
POST /v1/memory_stores/{memory_store_id}/memories アクティブな Memory Store にメモリエントリを作成します。レスポンスは メモリエントリオブジェクトで、content を含みます。

​
パスパラメータ

パラメータ型必須説明
memory_store_idstringはいMemory Store ID（memstore_ プレフィックス）

​
ヘッダー

ヘッダー値必須
AuthorizationBearer $QODER_PATはい
Content-Typeapplication/jsonはい

​
リクエストボディ

フィールド型必須説明
pathstringはい相対パス。サーバーが前後の空白を除去。最大 1024 バイト。/ で始まることはできず、.. を含むことはできない
contentstringはいテキスト内容。トリミング後に空白であってはならない。最大 100 KB
metadataメタデータオブジェクトいいえカスタムメタデータ。デフォルトは {}

​
リクエスト例

curl -X POST "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/memories" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "notes/meeting.md",
    "content": "会議議事録の内容...",
    "metadata": {
      "source": "meeting"
    }
  }'

​
レスポンス例

HTTP 201 Created 
{
  "id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "type": "memory",
  "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
  "path": "notes/meeting.md",
  "content": "会議議事録の内容...",
  "size": 24,
  "content_sha256": "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c",
  "version": 1,
  "metadata": {
    "source": "meeting"
  },
  "created_at": "2026-05-18T15:34:26.494349Z",
  "updated_at": "2026-05-18T15:34:26.494349Z"
}

​
レスポンスフィールド

フィールド型説明
idstringメモリエントリ ID、mem_ プレフィックス
typestring固定値 "memory"
store_idstring所属する Memory Store の ID
pathstringメモリの相対パス
contentstring作成されたエントリの内容
sizeinteger内容サイズ（バイト）
content_sha256string内容の SHA-256 ダイジェスト
versioninteger現在のエントリバージョン、初期値は 1
metadataメタデータオブジェクトカスタムメタデータ
created_atstringUTC 作成時刻
updated_atstringUTC 最終更新時刻

​
注意事項

  • path は同一ストア内のアクティブなエントリ間で一意です
  • エントリの作成により、action: "created" のバージョンレコードも作成されます
  • サーバーが size と content_sha256 を計算します

​
エラーレスポンス

HTTPtype説明
400invalid_request_error無効な path、空白または超過サイズの content、または無効な metadata
401authentication_error認証トークンが提供されていないまたは無効
404not_found_error指定の Memory Store が存在しない
409conflict_errorストアがアーカイブ済み、または同一 path のアクティブなエントリがすでに存在

​
関連項目

Memory Stores

Agent に Session をまたいだ永続メモリを与える。