Send an authorized LVOS staff follow-up request
send_appointment_requestSends an LVOS staff follow-up request that the user has explicitly authorized, using the confirmation token and idempotency key issued for those exact details. Saves an encrypted copy (deleted after 30 days) and emails practice staff, who contact the person. Repeating with the same idempotency key returns the original receipt. Does not book, reserve or confirm an appointment.
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": {
"practice_id": "<practice_id>",
"first_name": "<first_name>",
"last_name": "<last_name>",
"contact": "<contact>",
"appointment_type": "<appointment_type>",
"idempotency_key": "<idempotency_key>",
"confirmation_token": "<confirmation_token>",
"authorization_confirmed": "<authorization_confirmed>"
},
"name": "send_appointment_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contact | Yes | Exactly one way for staff to reach the patient. | |
| last_name | Yes | Patient last name, for example Lopez. | |
| first_name | Yes | Patient first name, for example Maria. | |
| practice_id | Yes | Always LVOS (Larchmont Village Oral Surgery). | |
| idempotency_key | Yes | The idempotency_key returned by prepare_appointment_request. Reuse it when retrying after an uncertain response. | |
| appointment_type | Yes | consult: the practice's 'Consult' type (about 30 minutes). surgery_consult: its 'Surgery Consult' type (about 60 minutes). Staff confirm the right type. | |
| confirmation_token | Yes | The confirmation_token returned by prepare_appointment_request. Valid for 15 minutes and only for the unchanged details. | |
| preferred_day_or_time | No | Optional scheduling preference, for example 'weekday mornings'. Not an available or reserved slot. No clinical details. | |
| authorization_confirmed | Yes | true only when the user has explicitly authorized sending the exact prepared details after seeing the disclosure. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| status | No | ||
| message | No | ||
| practice_id | No | ||
| submission_id | No | ||
| idempotency_key | No | ||
| notification_status | No | ||
| retry_after_seconds | No | ||
| confirms_appointment | No |