MINARA

Team の定期タスクを起動する

POST /v1/team/routine-hooks/:triggerId: 外部の JSON イベントを受信し、指示を Team のキューに追加します。

POST /v1/team/routine-hooks/:triggerId

外部の JSON イベントを受信し、設定済みの指示をユーザーメッセージとして対象 Team のキューに追加します。Team Coordinator が既存の処理でターンを実行します。サービスが稼働中で、ローカルネットワークから到達できる必要があります。クラウド経由の中継は提供しません。

メソッドPOST
パス/v1/team/routine-hooks/:triggerId
認証ゲートウェイ共通の認証なし
カテゴリsessions

リクエスト本文

{ "event": "changed", "evidence": { "source": "https://example.com/item" } }

レスポンス本文

{ "automation_run_id": "run_123", "duplicate": false }

補足

トリガー専用のシークレットが必要です。JSON オブジェクトの上限は 64 KiB です。有効な定期タスクは、最大 100 ターンをキューに受け付けます。

同じ冪等キーと同等の JSON を送ると、元の実行 ID、duplicate=true、HTTP 202 を返します。同じキーで JSON の内容が異なる場合は 409 を返します。キーがない場合、各呼び出しを個別に処理します。

HTTP 202 はメッセージとターンの永続化を示します。Team の作業完了は保証しません。元の JSON はサーバー側のターンコンテキストに保存され、すべての Agent が参照できます。公開メッセージや履歴のレスポンスには含まれません。

一時停止すると新しいトリガーを拒否します。受け付け済みのターンは続行します。シークレットを更新すると、古いシークレットは直ちに無効になります。

目次