Squadbase logo

実行状態の取得

Squadbase API 経由でエージェント実行の状態をポーリングします。

GEThttps://api.squadbase.dev/v0/agent/{agentId}/executions/{executionId}

エージェントの実行で開始した実行の現在の状態を返します。statusCOMPLETED(または失敗系の終端状態)になるまでこのエンドポイントをポーリングし、その後 実行結果の取得 を行います。

リクエストヘッダー

Prop

Type

Required

x-api-key ヘッダーはすべてのリクエストで必須です。詳細は 認証 を参照してください。

パスパラメータ

Prop

Type

Required

レスポンス — 200 OK

トリガーエンドポイントと同じ実行オブジェクトを返します。

{
  "executionId": "uuid",
  "agentId": "uuid",
  "status": "COMPLETED",
  "title": "週次サインアップ分析",
  "message": "今週のサインアップ動向を分析して",
  "startedAt": "ISO8601",
  "completedAt": "ISO8601",
  "createdAt": "ISO8601"
}

呼び出し例

curl 'https://api.squadbase.dev/v0/agent/<AGENT_ID>/executions/<EXECUTION_ID>' \
  -H 'x-api-key: <YOUR_API_KEY>'

executionId が存在しない、または path の agentId に属していない場合は 422notFound)を返します。詳細は エラー を参照してください。