POST /api/v1/cloud/dreams
指定された Memory Store を非同期で整理する Dream を作成します。Dream オブジェクト を返します。
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|---|---|
Authorization | はい | Bearer <PAT> |
Content-Type | はい | application/json |
リクエストボディ
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
inputs | array | はい | 入力リスト。memory_store 型の入力を 1 つ含める必要があり、任意で sessions 型の入力を含められる |
model | string | いいえ | モデル選択: auto（デフォルト）、lite、ultimate |
instructions | string | いいえ | カスタム整理指示、最大 4096 文字 |
inputs 要素
| フィールド | 型 | 説明 |
|---|---|---|
type | string | "memory_store" または "sessions" |
memory_store_id | string | type が memory_store の場合に必須 |
session_ids | array | type が 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 | 種別 | トリガー |
|---|---|---|
| 400 | invalid_request_error | inputs が空、memory_store 入力欠落、memory_store の重複、sessions が 100 件超過、無効なモデル、instructions が長すぎる |
| 401 | authentication_error | 認証トークンが欠落または無効 |
| 404 | not_found_error | 参照された Memory Store が存在しないかアクセス不可 |
| 409 | invalid_request_error | ユーザーにすでにアクティブな Dream（pending または running）がある |