Scout API・連携リファレンス

人による判断には製品画面を使用し、制御された自動化には REST API を使用します。フィールドとリクエスト形式は、各環境の OpenAPI を正式な参照先としてください。

Authentication

• Platform auth を使い、対象 tenant の account で実行。
• Scout endpoint は対応する scout.* permission が必要。
• Harness API の直接 read は platform.harness.read が必要。
• Request の tenant ID を authorization decision に使わない。
• Service credential を script や evidence に埋め込まない。

Scout Endpoint

Method	Endpoint	Permission
POST/GET	/api/v1/scout/missions	scout.write / scout.read
GET	/api/v1/scout/missions/{missionId}	scout.read
POST	/api/v1/scout/missions/{missionId}/snapshot	scout.write
POST	/api/v1/scout/missions/{missionId}/discovery	scout.write
GET	/api/v1/scout/missions/{missionId}/coverage[/{rowKey}]	scout.read
GET/POST	/api/v1/scout/missions/{missionId}/workbench[/candidates]	scout.read / scout.write
POST	/api/v1/scout/missions/{missionId}/workbench/candidates/{candidateId}/decision	scout.write
GET	/api/v1/scout/contracts[/{contractId}]	scout.read
POST	/api/v1/scout/contracts/{contractId}/versions/{version}/shadow	scout.write
POST	/api/v1/scout/contracts/{contractId}/versions/{version}/approve	scout.approve
POST	/api/v1/scout/contracts/{contractId}/versions/{version}/deploy	scout.deploy
GET	/api/v1/scout/missions/{missionId}/runtime-evidence	scout.read

Platform Harness Endpoint

• GET /api/v1/platform/harness/v1/capabilities
• POST /api/v1/platform/harness/v1/snapshots
• GET /api/v1/platform/harness/v1/snapshots/{snapshotId}
• GET /api/v1/platform/harness/v1/snapshots/{snapshotId}/components/{component}

Scout は shared Platform Harness を利用します。Scout 専用 context assembler を作らないでください。

Automation と再試行

create Mission -> read snapshot/Coverage -> create/decide candidate
-> read contract -> Shadow -> approve -> deploy -> Runtime Evidence

Immutable workflow receipt を作る mutation は UUID Idempotency-Key を使います。同じ logical request の retry にだけ同じ key を使います。Decision/transition の expectedVersion conflict 後は reload/review が必要です。

401 は再認証、403 は entitlement/module/tenant/permission、404 は tenant-scoped ID、409 は current state、429 は server window、5xx は trace ID と first broken stage を確認します。

現在のリリースでは、公開 Scout MCP ツールセットと署名付き外部スナップショット出力は提供していません。対象環境の OpenAPI に公開されたAPIのみを使用してください。