Dream の作成

POST /api/v1/forward/dreams Dream は Memory Store を直接整理するか、指定した Identity と Template の Default Memory を整理します。API が応答した後もタスクはバックグラウンドで実行されます。取得または一覧 API で状態を確認できます。

ヘッダー

Header	必須	説明
`Authorization`	はい	`Bearer <PAT or admin SAT>`。
`Content-Type`	はい	`application/json` を指定します。

リクエストボディ

フィールド	型	必須	デフォルト	説明
`inputs`	object[]	はい	—	入力の一覧。`memory_store` または `identity_template` 型の主要入力を必ず 1 つだけ含めます。`sessions` 入力を追加できます。
`model`	string	いいえ	`auto`	モデルのティア。`auto`、`lite`、`ultimate` のいずれか。
`instructions`	string	いいえ	`""`	カスタムの整理指示。最大 4096 文字。

`inputs` の要素

フィールド	型	必須	説明
`type`	string	はい	入力の型。`memory_store`、`identity_template`、`sessions` のいずれか。
`memory_store_id`	string	条件付き	`type=memory_store` の場合は必須。呼び出し元がアクセスできる Memory Store を指定します。
`identity_id`	string	条件付き	`type=identity_template` の場合は必須。
`template_id`	string	条件付き	`type=identity_template` の場合は必須。
`session_ids`	string[]	条件付き	`type=sessions` の場合は必須で、空にはできません。すべての `sessions` 入力を合わせて最大 100 個の Session ID を指定できます。

各入力には、その型で定義されたフィールドのみ指定できます。たとえば、identity_template 入力に memory_store_id を含めることはできません。 2 種類の主要入力の処理については、Dream input を参照してください。

リクエスト例

Identity と Template の Default Memory を整理する例：

curl -s -X POST 'https://api.qoder.com/api/v1/forward/dreams' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H 'Content-Type: application/json' \
  -d '{
    "inputs": [
      {
        "type": "identity_template",
        "identity_id": "idn_019eabc123",
        "template_id": "tmpl_support"
      },
      {
        "type": "sessions",
        "session_ids": ["sess_019e7a1b2c3d4e5f6a7b8c9d0e1f2a3b"]
      }
    ],
    "model": "auto",
    "instructions": "ユーザーが確認した長期的な好みを重点的に整理する"
  }'

Memory Store を直接整理する例：

curl -s -X POST 'https://api.qoder.com/api/v1/forward/dreams' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H 'Content-Type: application/json' \
  -d '{
    "inputs": [
      {
        "type": "memory_store",
        "memory_store_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4"
      }
    ]
  }'

レスポンス例

HTTP 201 Created

{
  "id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
  "type": "dream",
  "status": "pending",
  "inputs": [
    {
      "type": "identity_template",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support"
    },
    {
      "type": "sessions",
      "session_ids": ["sess_019e7a1b2c3d4e5f6a7b8c9d0e1f2a3b"]
    }
  ],
  "outputs": [],
  "model": { "id": "auto" },
  "instructions": "ユーザーが確認した長期的な好みを重点的に整理する",
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  },
  "error": null,
  "created_at": "2026-09-15T03:00:00Z",
  "ended_at": null,
  "archived_at": null
}

レスポンスフィールド

フィールド	型	説明
戻り値	object	新しく作成された Dream オブジェクト。

エラー

HTTP	Type	発生条件
`400`	`invalid_request_error`	リクエストボディまたは入力の組み合わせが無効です。`error.code` は `invalid_dream_inputs`、`too_many_sessions`、`invalid_model`、`instructions_too_long` のいずれかです。
`401`	`authentication_error`	認証情報がないか、無効または期限切れです。
`403`	`permission_error`	トークンに Dream の管理権限がありません。この API は Identity SAT に対応していません。
`404`	`not_found_error`	Memory Store が存在しないかアクセスできない、または指定した Identity、Template、Default Memory が存在しません。`error.code` は `memory_store_not_found` または `dream_scope_not_found` です。
`409`	`invalid_request_error`	現在の個人スペースまたは Workspace に、`pending` または `running` 状態の Dream がすでに存在します。
`413`	`invalid_request_error`	リクエストボディがサイズ制限を超えています。
`429`	`rate_limit_error`	リクエスト頻度または同時実行数の上限に達しています。
`500/502/503`	`api_error`	サービスまたは内部の依存サービスが一時的に利用できません。

Dream の作成

ヘッダー

リクエストボディ

`inputs` の要素

リクエスト例

レスポンス例

レスポンスフィールド

エラー

関連

Dream の取得

Dream の一覧

​ヘッダー

​リクエストボディ

​inputs の要素

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー

​関連

Dream の取得

Dream の一覧

ヘッダー

リクエストボディ

`inputs` の要素

リクエスト例

レスポンス例

レスポンスフィールド

エラー

関連