Copy

POST /api/v1/cloud/dreams/{id}/cancel 指定された Dream をキャンセルします。ステータスが pending または running の Dream のみキャンセル可能です。すでにキャンセル済みの Dream に対する cancel 呼び出しは冪等です。更新された Dream オブジェクトを返します。

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT または SAT>`

パスパラメータ

パラメータ	型	説明
`id`	string	Dream ID（`drm_` プレフィックス）

リクエスト例

curl -s -X POST 'https://api.qoder.com/api/v1/cloud/dreams/drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9/cancel' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
  "type": "dream",
  "status": "canceled",
  "inputs": [{ "type": "memory_store", "memory_store_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4" }],
  "outputs": [],
  "model": { "id": "auto" },
  "instructions": "",
  "session_id": "sess_019e86b4b10578059435632bb357c5ed",
  "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": "2026-06-15T10:01:15Z",
  "archived_at": null
}

エラー

HTTP	種別	トリガー
400	`invalid_request_error`	Dream が `completed` または `failed`（終了状態、キャンセル不可）。`canceled` は冪等で 200 を返す
401	`authentication_error`	認証トークンが欠落または無効
404	`not_found_error`	Dream が存在しない

完全なエラーエンベロープはエラーリファレンスを参照してください。

​ヘッダー

​パスパラメータ

​リクエスト例

​レスポンス例

​エラー

ヘッダー

パスパラメータ

リクエスト例

レスポンス例

エラー