Generate Patient Suggestions
curl --request POST \
--url https://api.decodahealth.com/ai/patient/suggestions \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--header 'TENANT: <tenant>' \
--data '
{
"context": {
"patient": {
"firstName": "<string>",
"lastName": "<string>",
"dateOfBirth": "<string>",
"gender": "<string>",
"phoneNumber": "<string>",
"email": "<string>",
"createdDate": "<string>"
},
"upcomingAppointments": [
{
"title": "<string>",
"start": "<string>",
"id": "<string>",
"status": "<string>",
"providerName": "<string>"
}
],
"recentAppointments": [
{
"title": "<string>",
"start": "<string>",
"id": "<string>",
"status": "<string>",
"providerName": "<string>"
}
],
"recentNotes": [
{
"createdDate": "<string>",
"summary": "<string>",
"answers": [],
"questions": []
}
],
"measurements": [
{
"measurementDate": "<string>",
"weight": 123,
"height": 123,
"systolicBp": 123,
"diastolicBp": 123,
"pulse": 123,
"temperature": 123,
"waistCircumference": 123
}
],
"medications": [
{
"name": "<string>",
"amount": 123,
"unit": "<string>",
"frequency": "<string>",
"quantity": 123,
"comment": "<string>",
"administrationLocation": "<string>"
}
],
"recentCharges": [
{
"id": "<string>",
"total": 123,
"totalOutstanding": 123,
"status": "<string>",
"description": "<string>",
"createdDate": "<string>",
"items": [
{
"quantity": 123,
"price": 123,
"name": "<string>",
"description": "<string>",
"discountAmount": 123
}
],
"payments": [
{}
]
}
],
"recentForms": [
{
"submissionDate": "<string>",
"isCompleted": true,
"name": "<string>"
}
],
"quickNotes": [
{
"note": "<string>",
"createdDate": "<string>",
"eventId": "<string>"
}
],
"tenant": {
"name": "<string>",
"timezone": "<string>"
}
},
"modelName": "gemini-2.5-flash-lite",
"useStructuredOutput": false,
"conversationHistory": [
{
"content": "<string>",
"timestamp": "<string>",
"files": [
{
"name": "<string>",
"size": 123,
"type": "<string>",
"data": "<string>"
}
]
}
],
"files": [
{
"name": "<string>",
"size": 123,
"type": "<string>",
"data": "<string>"
}
]
}
'{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Ai
Generate Patient Suggestions
Generate follow-up question suggestions.
POST
/
ai
/
patient
/
suggestions
Generate Patient Suggestions
curl --request POST \
--url https://api.decodahealth.com/ai/patient/suggestions \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--header 'TENANT: <tenant>' \
--data '
{
"context": {
"patient": {
"firstName": "<string>",
"lastName": "<string>",
"dateOfBirth": "<string>",
"gender": "<string>",
"phoneNumber": "<string>",
"email": "<string>",
"createdDate": "<string>"
},
"upcomingAppointments": [
{
"title": "<string>",
"start": "<string>",
"id": "<string>",
"status": "<string>",
"providerName": "<string>"
}
],
"recentAppointments": [
{
"title": "<string>",
"start": "<string>",
"id": "<string>",
"status": "<string>",
"providerName": "<string>"
}
],
"recentNotes": [
{
"createdDate": "<string>",
"summary": "<string>",
"answers": [],
"questions": []
}
],
"measurements": [
{
"measurementDate": "<string>",
"weight": 123,
"height": 123,
"systolicBp": 123,
"diastolicBp": 123,
"pulse": 123,
"temperature": 123,
"waistCircumference": 123
}
],
"medications": [
{
"name": "<string>",
"amount": 123,
"unit": "<string>",
"frequency": "<string>",
"quantity": 123,
"comment": "<string>",
"administrationLocation": "<string>"
}
],
"recentCharges": [
{
"id": "<string>",
"total": 123,
"totalOutstanding": 123,
"status": "<string>",
"description": "<string>",
"createdDate": "<string>",
"items": [
{
"quantity": 123,
"price": 123,
"name": "<string>",
"description": "<string>",
"discountAmount": 123
}
],
"payments": [
{}
]
}
],
"recentForms": [
{
"submissionDate": "<string>",
"isCompleted": true,
"name": "<string>"
}
],
"quickNotes": [
{
"note": "<string>",
"createdDate": "<string>",
"eventId": "<string>"
}
],
"tenant": {
"name": "<string>",
"timezone": "<string>"
}
},
"modelName": "gemini-2.5-flash-lite",
"useStructuredOutput": false,
"conversationHistory": [
{
"content": "<string>",
"timestamp": "<string>",
"files": [
{
"name": "<string>",
"size": 123,
"type": "<string>",
"data": "<string>"
}
]
}
],
"files": [
{
"name": "<string>",
"size": 123,
"type": "<string>",
"data": "<string>"
}
]
}
'{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.decodahealth.com/llms.txt
Use this file to discover all available pages before exploring further.
Headers
The tenant you are making this request on behalf of
Your api key
Body
application/json
Request schema for generating follow-up suggestions.
Patient context from frontend
Show child attributes
Show child attributes
Model to use for generation
Whether to request structured JSON output
Previous conversation messages for context
Show child attributes
Show child attributes
File attachments for the current request
Show child attributes
Show child attributes
Response
Successful Response
⌘I
