Run Compliance Test
runComplianceTestRun a compliance test against a phone number. The test calls the number, executes a regulatory probe script (e.g., requests data deletion, asks about AI disclosure), and returns pass/fail per probe. Returns the run resource; poll getRunResults for completion.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"phoneNumber": "<phoneNumber>",
"sector": "<sector>",
"testIds": "<testIds>"
},
"name": "runComplianceTest"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sector | Yes | Regulatory sector to evaluate against (e.g. `financial-services`, `telco`, `all`). Each `testId` must declare this sector in its catalogue `sectors` array, or be tagged `sectors: [all]`. See `listComplianceCatalogue` for the full set of available sector identifiers and their applicable tests. | |
| testIds | Yes | Array of compliance test IDs (one per probe) to run against `phoneNumber`. Each ID corresponds to one entry in `listComplianceCatalogue` (pattern `M-NNN`). Batch size is capped by the workspace tier's `pickerLimit` — see the 402 `BATCH_SIZE_EXCEEDS_TIER` response for the limit. | |
| phoneNumber | Yes | Target phone number for the compliance probe, in E.164 format (e.g. `+442012345678`). All `testIds` in the batch are dispatched against this single number. | |
| carrierRouteId | No | Bring-your-own-carrier (invite-only). Dial every test in this audit through one of the workspace's carrier routes, over the workspace's own SIP trunk, instead of nopaque's network. Carrier routes are set up with nopaque. The route sent becomes this number's default, so later audits keep it; omit the key to use the stored default, or pass `null` to dial over nopaque's network and clear the default. An audit with a route dials through it or not at all: if the route cannot be dialled, nothing is run (409, 429 when the trunk has used today's minutes, 403 or 503). Carrier calls are metered as `carrier_compliance`, from answer, and count toward the trunk's daily minutes. Each run records the route as `carrier {integrationId, routeId}`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runIds | Yes | ||
| reportUrl | Yes | Relative URL of the by-phone aggregator report. |