Dream の一覧

GET /api/v1/forward/dreams 作成日時の新しい順に返されます。アーカイブ済みの Dream はデフォルトでは含まれません。

ヘッダー

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

クエリパラメーター

パラメーター	型	必須	デフォルト	説明
`limit`	integer	いいえ	`20`	1 ページあたりの件数。範囲は `1-100`。
`after_id`	string	いいえ	—	現在のページの最後の Dream ID。より古いレコードの取得に使用します。
`before_id`	string	いいえ	—	現在のページの最初の Dream ID。新しいレコードがある前のページに戻るために使用します。
`include_archived`	boolean	いいえ	`false`	アーカイブ済みの Dream を含めるかどうか。`true` または `false` のみ指定できます。

before_id と after_id は同時に使用できません。クエリパラメーターの重複や、未定義のパラメーターは許可されません。

リクエスト例

curl -s 'https://api.qoder.com/api/v1/forward/dreams?limit=20&include_archived=true' \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "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"]
      }],
      "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
    }
  ],
  "first_id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
  "last_id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
  "has_more": false
}

空の一覧のレスポンス

{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

レスポンスフィールド

フィールド	型	説明
`data`	object[]	現在のページの Dream オブジェクト。
`first_id`	string/null	現在のページの最初の Dream ID。空の一覧では `null`。
`last_id`	string/null	現在のページの最後の Dream ID。空の一覧では `null`。
`has_more`	boolean	現在のページング方向に続きのレコードが存在するかどうか。

エラー

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

Dream の一覧

ヘッダー

クエリパラメーター

リクエスト例

レスポンス例

空の一覧のレスポンス

レスポンスフィールド

エラー

関連

Dream の作成

Dream の取得

​ヘッダー

​クエリパラメーター

​リクエスト例

​レスポンス例

​空の一覧のレスポンス

​レスポンスフィールド

​エラー

​関連

Dream の作成

Dream の取得

ヘッダー

クエリパラメーター

リクエスト例

レスポンス例

空の一覧のレスポンス

レスポンスフィールド

エラー

関連