Dream の取得

GET /api/v1/forward/dreams/{id} Dream の作成後、status が終端状態の completed、failed、canceled のいずれかになるまで、この API をポーリングできます。

ヘッダー

Header	必須	説明
`Authorization`	はい	`Bearer <PAT or admin SAT>`。

パスパラメーター

パラメーター	型	必須	説明
`id`	string	はい	`drm_` プレフィックスを持つ Dream ID。

リクエスト例

curl -s 'https://api.qoder.com/api/v1/forward/dreams/drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9' \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK

{
  "id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
  "type": "dream",
  "status": "completed",
  "inputs": [{
    "type": "identity_template",
    "identity_id": "idn_019eabc123",
    "template_id": "tmpl_support"
  }],
  "outputs": [{
    "type": "memory_store",
    "memory_store_id": "memstore_019e86b4b10578059435632bb357c5ed",
    "files_touched": ["preferences.md", "project/architecture.md"]
  }],
  "model": { "id": "auto" },
  "instructions": "ユーザーが確認した長期的な好みを重点的に整理する",
  "usage": {
    "input_tokens": 12500,
    "output_tokens": 3200,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 8000
  },
  "error": null,
  "created_at": "2026-09-15T03:00:00Z",
  "ended_at": "2026-09-15T03:03:42Z",
  "archived_at": null
}

レスポンスフィールド

フィールド	型	説明
戻り値	object	現在の状態の Dream オブジェクト。

エラー

HTTP	Type	発生条件
`400`	`invalid_request_error`	`id` が有効な Dream ID ではありません。`error.code` は `invalid_dream_id` です。
`401`	`authentication_error`	認証情報がないか、無効または期限切れです。
`403`	`permission_error`	トークンに Dream の参照権限がありません。この API は Identity SAT に対応していません。
`404`	`not_found_error`	Dream が存在しないか、呼び出し元から参照できません。`error.code` は `dream_not_found` です。
`500/502/503`	`api_error`	サービスまたは内部の依存サービスが一時的に利用できません。

Dream の取得

ヘッダー

パスパラメーター

リクエスト例

レスポンス例

レスポンスフィールド

エラー

関連

Dream の一覧

Dream のキャンセル

Dream のアーカイブ

​ヘッダー

​パスパラメーター

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー

​関連

Dream の一覧

Dream のキャンセル

Dream のアーカイブ

ヘッダー

パスパラメーター

リクエスト例

レスポンス例

レスポンスフィールド

エラー

関連