---
title: "Run Agent Soundcheck (free)"
method: POST
path: "/api/v1/engines/agent-soundcheck/run"
---

# Run Agent Soundcheck (free)

`POST /api/v1/engines/agent-soundcheck/run`

## Request

- Base URL: `https://signalband.net`
- URL: `https://signalband.net/api/v1/engines/agent-soundcheck/run`
- Auth: one of:
  - none
  - HTTP bearer

For AI agents: checks whether a Signal Band engine, Power BI pack or practitioner fits the owner's decision before you recommend a purchase. Returns a fit range, one action and the offers to show the owner. Never recommends buying without the owner's approval.

## Request body

- object
  - `decision` 'startup-quick-read' | 'venture-readiness' | 'ai-investment' | 'org-quick-read' | 'tech-debt' | 'workforce' | 'cyber-capability' | 'ai-governance' | 'release-governance' | 'cyber-program' | 'identity-program' | 'portfolio-delivery' | 'other', required: The kind of decision the owner faces
  - `description` string: One or two sentences on the decision, for the record
  - `stakes` 'internal' | 'customer-facing' | 'compliance-or-investment'
  - `alternative` 'practitioner' | 'analyst' | 'agent-ad-hoc' | 'nothing': What the owner would do otherwise
  - `inputsAvailable` string[]: Inputs the owner already has. See each engine spec for what the items mean.
  - `runsPerMonth` integer
  - `forClients` boolean: True if results will be delivered to the owner's own clients (commercial licence)
  - `budgetUSD` number

## Response `200`

Result with provenance

- RunResult
  - `engine` string
  - `result` object
  - `creditsUsed` integer
  - `provenance` object

## Other responses

- `401`: Error
- `402`: Error
- `422`: Error
- `429`: Error

---

[API](https://skmtc.dev/signalband/apis/signal-band-decision-engines.md) · [All operations](https://skmtc.dev/signalband/apis/signal-band-decision-engines/llms.txt) · [OpenAPI document](https://skmtc.dev/signalband/apis/signal-band-decision-engines/revisions/be73c95c8797?raw)