Trigger an assessment
trigger_assessmentTrigger a security assessment run against one of your targets, an agent or an MCP server. Optionally focus an agent's run on specific taxonomy categories — call list_categories to discover valid keys; a key outside the runnable lens is rejected as invalid_argument rather than starting a run that produces no findings. An MCP server's run always covers all of its categories, so it takes none. Returns immediately with a run_id; the run executes in the background — poll get_assessment_status for progress and the verdict. Requires the test:run scope.
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": {
"model_id": "<model_id>"
},
"name": "trigger_assessment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model_id | Yes | ||
| categories | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes | Poll with get_assessment_status. | |
| status | Yes | Always 'running' at trigger time. | |
| model_id | Yes | The target (agent) model the run is assessing. | |
| started_at | Yes | ISO-8601 UTC. |