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

​
エンドポイント

POST http://localhost:8080/api/v1/approvals/decision

​
説明

人間の承認を待機しているワークフローに対して、承認または拒否を送信します。成功すると、決定がワークフローに通知され、実行が続行されるか（または終了します）。

​
認証

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

​
リクエスト

​
ヘッダー

ヘッダー必要説明
X-API-KeyはいAPI認証キー
Content-Typeはいapplication/json
traceparentいいえW3Cトレースコンテキスト

​
ボディパラメータ

パラメータ型必要説明
workflow_idstringはい対象ワークフローID
approval_idstringはい承認識別子
approvedbooleanはい承認または拒否
feedbackstringいいえオプションのフィードバック/コメント
modified_actionstringいいえオプションの修正アクション
run_idstringいいえ特定の実行ID（オプション）
approved_bystringいいえ認証されたユーザーがデフォルト

​
リクエストボディスキーマ

{
  "workflow_id": "task-123",
  "approval_id": "appr-456",
  "approved": true,
  "feedback": "Looks good",
  "modified_action": "",
  "run_id": ""
}

​
レスポンス

​
200 OK

{
  "status": "sent",
  "success": true,
  "message": "Approval appr-456 processed successfully",
  "workflow_id": "task-123",
  "run_id": "",
  "approval_id": "appr-456"
}

​
400 / 401 / 403 / 404

{ "error": "..." }

​
例

​
承認 (curl)

curl -X POST "http://localhost:8080/api/v1/approvals/decision" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "task-123",
    "approval_id": "appr-456",
    "approved": true,
    "feedback": "Proceed"
  }'

​
拒否 (Python / httpx)

import httpx

httpx.post(
  "http://localhost:8080/api/v1/approvals/decision",
  headers={"X-API-Key": api_key, "Content-Type": "application/json"},
  json={"workflow_id": wid, "approval_id": appr, "approved": False, "feedback": "Not safe"}
)

​
注意事項

  • http://localhost:8081/approvals/decision のレガシー管理エンドポイントを置き換えます（非推奨）。