Submit Consent
consent_submitRecord a patient's consent confirmation for a specific consent document. The agent must have already presented the full consent text (from consent_text) to the patient and received explicit confirmation. Required parameters: intake_id, consent_id, the patient's exact confirmation text (e.g. 'I agree'), consent method ('ai_agent_conversational'), the AI platform name ('chatgpt', 'claude', 'gemini'), and a session/conversation ID for audit trail. Returns a consent record with timestamp, audit trail details, and the list of remaining consents still needed. All consent records are retained for 10 years per HIPAA requirements. Requires authentication.
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": {
"intake_id": "<intake_id>",
"consent_id": "<consent_id>",
"patient_confirmation": "<patient_confirmation>"
},
"name": "consent_submit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| intake_id | Yes | Intake ID this consent belongs to | |
| timestamp | No | ISO 8601 timestamp of consent confirmation | |
| consent_id | Yes | Consent document ID being confirmed | |
| bearer_token | No | Authentication token for the patient session | |
| agent_platform | No | AI platform name: 'chatgpt', 'claude', or 'gemini' | |
| consent_method | No | Method of consent collection | ai_agent_conversational |
| agent_session_id | No | Unique session/conversation ID for audit trail | |
| patient_confirmation | Yes | Patient's exact confirmation text (e.g. 'I agree') |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |