Skip to main content
Dreams

Dream のアーカイブ

終了した Dream をアーカイブします。

POST /api/v1/forward/dreams/{id}/archive completed、failed、canceled 状態の Dream のみアーカイブできます。アーカイブ済みの Dream に対する再呼び出しでは、冪等に現在のオブジェクトを返します。 アーカイブしても Dream は削除されません。アーカイブ済みのレコードはデフォルトの一覧に含まれませんが、include_archived=true で取得できます。

ヘッダー

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

パスパラメーター

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

リクエスト例

curl -s -X POST 'https://api.qoder.com/api/v1/forward/dreams/drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9/archive' \
  -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"]
  }],
  "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": "2026-09-15T06:00:00Z"
}

レスポンスフィールド

フィールド型説明
戻り値objectアーカイブ後の Dream オブジェクト。archived_at は null ではありません。

エラー

HTTPType発生条件
400invalid_request_errorid が無効、リクエストボディが空でない、または Dream が終端状態に達していません。error.code は invalid_dream_id、invalid_request_body、dream_not_archivable のいずれかです。
401authentication_error認証情報がないか、無効または期限切れです。
403permission_errorトークンに Dream の管理権限がありません。この API は Identity SAT に対応していません。
404not_found_errorDream が存在しないか、呼び出し元から参照できません。error.code は dream_not_found です。
429rate_limit_errorリクエスト頻度の上限に達しています。
500/502/503api_errorサービスまたは内部の依存サービスが一時的に利用できません。

関連