メインコンテンツへスキップ

エンドポイント

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

説明

一時停止されたタスクを再開します。ワークフローは最後のチェックポイントから続行され、通常通り進行します。

認証

必要: はい ヘッダーにAPIキーを含めてください:
X-API-Key: sk_test_123456

リクエスト

ヘッダー

ヘッダー必要説明
X-API-KeyはいAPI認証キー
Content-Typeいいえボディがある場合はapplication/json
traceparentいいえW3Cトレースコンテキスト

パスパラメータ

パラメータタイプ必要説明
idstringはいタスクID(TemporalワークフローID)

ボディパラメータ

パラメータタイプ必要説明
reasonstringいいえオプションの再開理由ノート

リクエストボディの例

{
  "reason": "User approved continuation"
}

レスポンス

202 Accepted

{
  "success": true,
  "message": "Resume signal sent",
  "task_id": "task-123"
}

404 Not Found

{ "error": "Task not found" }

409 Failed Precondition

無効な状態でタスクを再開できません:
{ "error": "cannot resume completed task" }
{ "error": "cannot resume failed task" }
{ "error": "cannot resume cancelled task" }
{ "error": "cannot resume timed out task" }
{ "error": "task is not paused" }

401 / 403

{ "error": "Unauthorized" }
または
{ "error": "Forbidden" }

注意事項

  • 現在一時停止されているタスクにのみ効果があります。非一時停止タスクに対してresumeを呼び出すと、409 Failed Preconditionエラーが返されます。
  • 状態検証により、無効な操作(例:完了したタスクやすでに実行中のタスクの再開)に対して明確なエラーメッセージが提供されます。
  • SSEストリームは、一時停止されたワークフローが再開されるとworkflow.resumedを発信します。