Diagnostic EngineConversations
Create conversation
Create a conversation — a state container for a multi-turn diagnostic session. For actual inference, use chat endpoint.
AuthorizationBearer <token>
In: header
patientPatient
Patient demographics for this session.
personality?Personality
Assistant tone.
Default
"professional"Value in
"professional" | "friendly"language?Language
Conversation language.
Default
"en"Value in
"en" | "ar"recommend_specialist?Recommend Specialist
Include specialist recommendation in diagnosis.
Default
truespecify_urgency?Specify Urgency
Include urgency level in diagnosis.
Default
trueadvise_self_management?Advise Self Management
Include self-management advice in diagnosis.
Default
truecoding_systemPublicCodingSystem
Coding system used in the conversation.
Value in
"aut" | "icd10_cm" | "snomed"Response Body
curl -X POST "https://api.avey.ai/ddx/v1/conversations" \ -H "Content-Type: application/json" \ -d '{ "patient": { "age": 34, "sex": "male" }, "personality": "professional", "language": "en", "coding_system": "snomed" }'{
"id": "conv_e389786b611e",
"created_at": 1774530598,
"is_complete": false,
"patient": {
"age": 34,
"sex": "male"
},
"personality": "professional",
"language": "en",
"coding_system": "snomed",
"messages": [],
"findings": []
}{
"error": {
"code": "string",
"message": "string"
}
}How is this guide?