タスク一時停止

Documentation Index

Fetch the complete documentation index at: https://docs.shannon.run/llms.txt

Use this file to discover all available pages before exploring further.

​

エンドポイント

POST http://localhost:8080/api/v1/tasks/{id}/pause

​

説明

​

認証

X-API-Key: sk_test_123456

​

リクエスト

​

ヘッダー

​

パスパラメータ

​

ボディパラメータ

​

リクエストボディの例

{
  "reason": "ユーザーが中間結果をレビューしている間に一時停止"
}

​

レスポンス

​

202 Accepted

{
  "success": true,
  "message": "一時停止信号が送信されました",
  "task_id": "task-123"
}

​

404 Not Found

{ "error": "タスクが見つかりません" }

​

409 Failed Precondition

{ "error": "完了したタスクを一時停止できません" }

{ "error": "失敗したタスクを一時停止できません" }

{ "error": "キャンセルされたタスクを一時停止できません" }

{ "error": "タイムアウトしたタスクを一時停止できません" }

{ "error": "タスクはすでに一時停止しています" }

​

401 / 403

{ "error": "認証されていません" }

{ "error": "禁止されています" }

​

注意事項

• 一時停止は明確に定義されたチェックポイント（例：pre_execution、pre_completion）で効果を発揮し、進行中のアクティビティを中断しません。
• 一時停止中、SSEストリームはworkflow.pausingおよびworkflow.pausedイベントをcheckpointフィールドと共に発信します。
• 所有権とテナンシーが強制されます：ユーザーは自分のタスクのみを一時停止できます。