メインコンテンツへスキップ
POST /v1/dreams 指定された Memory Store を非同期で整理する Dream を作成します。Dream オブジェクト を返します。

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer <PAT>
Content-Typeはいapplication/json

​
リクエストボディ

フィールド型必須説明
inputsarrayはい入力リスト。memory_store 型の入力を 1 つ含める必要があり、任意で sessions 型の入力を含められる
modelstringいいえモデル選択: auto（デフォルト）、lite、ultimate
instructionsstringいいえカスタム整理指示、最大 4096 文字

​
inputs 要素

フィールド型説明
typestring"memory_store" または "sessions"
memory_store_idstringtype が memory_store の場合に必須
session_idsarraytype が sessions の場合に必須、最大 100 件

​
リクエスト例

curl -s -X POST 'https://api.qoder.com/api/v1/cloud/dreams' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      { "type": "memory_store", "memory_store_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4" },
      { "type": "sessions", "session_ids": ["sess_019e7a1b2c3d4e5f6a7b8c9d0e1f2a3b"] }
    ],
    "model": "auto",
    "instructions": "Focus on user preferences for code style"
  }'

​
レスポンス例

HTTP 201 Created 
{
  "id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
  "type": "dream",
  "status": "pending",
  "inputs": [
    { "type": "memory_store", "memory_store_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4" },
    { "type": "sessions", "session_ids": ["sess_019e7a1b2c3d4e5f6a7b8c9d0e1f2a3b"] }
  ],
  "outputs": [],
  "model": { "id": "auto" },
  "instructions": "Focus on user preferences for code style",
  "session_id": null,
  "usage": { "input_tokens": 0, "output_tokens": 0, "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0 },
  "error": null,
  "created_at": "2026-06-15T10:00:00Z",
  "ended_at": null,
  "archived_at": null
}

​
エラー

HTTP種別トリガー
400invalid_request_errorinputs が空、memory_store 入力欠落、memory_store の重複、sessions が 100 件超過、無効なモデル、instructions が長すぎる
401authentication_error認証トークンが欠落または無効
404not_found_error参照された Memory Store が存在しないかアクセス不可
409invalid_request_errorユーザーにすでにアクティブな Dream（pending または running）がある
完全なエラーエンベロープは エラーリファレンス を参照してください。