Start scan
start_scanStart a creator scan for an app (spends scan credits). Same gates as the dashboard: active subscription required, and a queued/running scan for the app refuses with scan_in_progress. Guarded: without approval_token it returns {error:"approval_required", approval_token, summary} for the user to confirm; call again with the token. Every dashboard guardrail still applies: this is exactly what a user clicking the dashboard could do, no more.
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": {
"app_id": "<app_id>",
"type": "<type>"
},
"name": "start_scan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | quick = fast pass; full = complete scan. | |
| app_id | Yes | An app id from list_apps. | |
| approval_token | No | Approval token from a previous approval_required response, after the user said yes. |