Skip to main content
Live scan prompts let you send a message into a running pentest agent graph. The feature is enterprise-only. Use this endpoint to target the currently selected agent in the scan UI, or omi t agent_id to default to the root agent.

​
Send a live prompt

The request body supports:
  • message — required text to send to the running scan
  • cancel_current — optional boolean; set to true to interrupt the active a gent turn before sending
  • agent_id — optional target agent id; defaults to the scan root agent
Required scope: scans:message

​
Readiness and errors

The API enforces the same guardrails as the dashboard UI:
  • 403 if the organization does not have the enterprise live_scan_prompt fea ture
  • 409 if the scan is not active (pending or running)
  • 503 until the scan sandbox bridge is ready
When the bridge is ready, the prompt is forwarded to the running agent over the scan sandbox’s /user-message endpoint.