Submit Response
submit_responseProvide an answer to the current step in a compliance workflow. Use this when someone provides information requested by the workflow, such as 'our system processes health data' or 'we use AES-256 encryption'. The workflow engine validates the response and advances to the next step. Pass user_acknowledged=true only after the user has supplied the fields listed in user_provided_fields. evidence_references accepts document UUIDs, doc:// segment URIs, or regulatory URLs. For an unattended gate, pass approved_by='auto' and leave user_acknowledged=false so the report does not misrepresent automation as human review. approved_by accepts only 'auto'; human review is asserted via user_acknowledged, never by naming an approver. Generate one UUID as submission_id and reuse it only when retrying the exact same payload after a timeout.
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": {
"workflow_id": "<workflow_id>",
"step_id": "<step_id>",
"responses": "<responses>"
},
"name": "submit_response"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| step_id | Yes | Id of the step being answered, as reported by get_current_step. | |
| responses | Yes | The step's answers, keyed by the field names the step asked for. Values follow the expected input format get_current_step returned for that step. | |
| approved_by | No | Accepts only 'auto', which marks the gate as passed unattended. Human review is asserted through user_acknowledged, never by naming an approver here. | |
| workflow_id | Yes | Id of the workflow run, as returned by start_workflow. Recover a lost id with list_workflows. | |
| fetched_data | No | Supporting material the agent gathered for this step — search results, provision text, document excerpts — passed through to the workflow engine alongside the answers. | |
| evidence_tier | No | The evidence grade backing this answer, when the step asks for one. Omit unless the step's contract names it. | |
| submission_id | No | Retry key for this exact payload. Generate one UUID per logical submission and reuse it only for byte-equivalent retries. | |
| compliance_level | No | The compliance level asserted for this step, when the step asks for one. Omit unless the step's contract names it. | |
| user_acknowledged | No | Set true only after the human has supplied the fields listed in the step's user_provided_fields. This is the assertion of human review; leave false for an unattended gate so the report does not present automation as human review. | |
| evidence_references | No | References backing the answer: document UUIDs, doc:// segment URIs, or regulatory URLs. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |