Retrieving Dyna Conversation History by ID GET
The Dyna API GET /v1/content/search/rag/conversations/{id} endpoint allows you to retrieve a single past Dyna AI conversation for a user. Since this endpoint returns information specific to a user’s account, an ID token is required.
The following information is the minimum required to execute a request for this endpoint:
Headers
- Authorization: a personalized access token
- x-eis-id-token: an ID token
Conversation ID
- conversationId: The ID of the conversation to return. The ID will have the following format: YYYY-MM-DD-GUID
Basic Conversation Retrieval Example
To retrieve a conversation for a user, use the headers required above and submit a request similar to the URL below after substituting a valid conversation ID into the URL in place of YYYY-MM-DD-GUID.
Additionally, be sure to specify media parameters that should match the media parameters used on the Dyna search:
- imageSize – small (thumbnail), medium, large, or full
- convertSvg - Returns images and algorithms that are originally in svg format as png format.
Please see the Dyna query documentation for more details.
Request
GET 'https://apis.ebsco.com/medsapi-dynamic-health/v1/content/search/rag/conversations/YYYY-MM-DD-GUID'Response
You will receive a response similar to the one below:
{
"_metadata": {
"links": [
{
"rel": "first",
"href": "https://apis.ebsco.com/medsapi-dynamic-health/v1/content/search/rag/conversations/YYYY-MM-DD-GUID"
},
{
"rel": "self",
"href": "https://apis.ebsco.com/medsapi-dynamic-health/v1/content/search/rag/conversations/YYYY-MM-DD-GUID"
}
]
},
"items": [
{
"supported": true,
"query": "fall risk",
"question": "How is fall risk assessed?",
"answer": " Fall risk is assessed using validated tools that vary in design, sensitivity, specificity, and generalizability. These tools can be monofactorial or multifactorial, measuring risk factors such as history of falls, fear of falling, physical environment, and physical status.1 Examples of fall risk assessment tools include:Peninsula Health Fall Risk Assessment Tool (PH-FRAT)2,3Falls Assessment, Risk and Management (FARAM)2,3Hendrich II Fall-risk Model2,3Johns Hopkins Fall-risk Assessment Tool2,3Morse Fall Scale (MFS)2,3Tinetti Performance Oriented Mobility Assessment (POMA)2,3St Thomas’ Risk Assessment Tool in Falling Elderly Inpatients (STRATIFY)2,3Peter James Centre Falls Risk Assessment Tool (PJC-FRAT)2,3Targeted Solutions Tool2,3 For pediatric patients, adult fall risk assessment tools are not applicable due to differences in behavior and motor skills. Validated pediatric fall risk assessment tools include:General Risk Assessment for Pediatric Inpatient Falls (GFRAF-PIF)4CHAMPS pediatric falls risk assessment tool4Pediatric Fall Risk Assessment (PFRA) Tool4Humpty Dumpty Scale4Cummings Pediatric Fall Assessment Tool4 Comprehensive assessments may include fall history, medication review, physical therapy examination, functional and environmental assessments, and cognitive evaluations.5,6",
"answerFound": true,
"conversationId": "YYYY-MM-DD-GUID",
"messageId": "0",
"disclaimer": {
"content": "Dyna AI responses are for educational purposes only and should not be solely relied upon for medical practice.",
"moreContent": "The presentation of a response does not imply any specific ranking by importance or probability and a response may not include all possibly relevant material. Interpretation and application are subject to the judgment of a healthcare professional. Dyna AI responses are not intended to serve as recommendations for individual patients. Do not enter Protected Health Information (PHI)."
},
"workplaceNotes": {
// workplaceNotes is only included for DH users if there is a workplace note associated with any of the references used by Dyna AI when generating a response
"message": "A note from your workplace is included that should be reviewed. (Notes are not included in the Dyna AI response)"
},
"workplaceSkills": {
// workplaceNotes is only included for DH users if there is a workplace note associated with any of the references used by Dyna AI when generating a response
"message": "One or more related 'Your Workplace Skills' exist and are not included in this Dyna AI response",
"results": [
{
"url": "/skill/example-skill",
"title": "Example Workplace Skill",
"id": "C12345",
}
]
},
"references": {
"title": "Dynamic Health Sources",
"hasNotes": true,
"results": [
{
"slug": "/nursing-skills/using-a-fall-risk-assessment-tool",
"title": "Using a Fall Risk Assessment Tool >",
"sections": [
{
"title": "Care Considerations",
"slug": "/nursing-skills/using-a-fall-risk-assessment-tool",
"anchor": "NURSING_CONSIDERATIONS",
"breadcrumb": null,
"index": "1",
"refIndex": 1,
"metadata": {
"title": "Using a Fall Risk Assessment Tool",
"navigateTo": [
"Care Considerations"
],
"id": "T12345",
"pubType": {
"pretty": "Nursing Skill",
"id": "nursingskills",
"group": "articles"
}
}
},
{
"title": "Preprocedure Steps",
"slug": "/nursing-skills/using-a-fall-risk-assessment-tool",
"anchor": "PRE_PROCEDURE_STEPS",
"breadcrumb": "Procedure >",
"index": "2",
"refIndex": 2,
"metadata": {
"title": "Using a Fall Risk Assessment Tool",
"navigateTo": [
"Procedure",
"Preprocedure Steps"
],
"id": "T12345",
"pubType": {
"pretty": "Nursing Skill",
"id": "nursingskills",
"group": "articles"
}
}
},
{
"title": "Procedure Steps",
"slug": "/nursing-skills/using-a-fall-risk-assessment-tool",
"anchor": "PROCEDURE_STEPS",
"breadcrumb": "Procedure >",
"index": "3",
"refIndex": 3,
"metadata": {
"title": "Using a Fall Risk Assessment Tool",
"navigateTo": [
"Procedure",
"Procedure Steps"
],
"id": "T12345",
"pubType": {
"pretty": "Nursing Skill",
"id": "nursingskills",
"group": "articles"
}
}
}
],
"hasNote": false,
"metadata": {
"title": "Using a Fall Risk Assessment Tool",
"id": "T12345"
}
}
]
},
"media": {
"images": {
"title": "Images:",
"results": [
{
"id": "I1677700339398",
"publicId": "EBSCOHealth/CCMS/Dynamed/images/I1677700339398",
"title": "Hip fracture identified by PoCUS",
"description": "Right occult hip fracture. A patient with a history of non-weight-bearing right leg following a fall. Initial plain radiographs were inconclusive. PoCUS assessment demonstrated displacement of the joint capsule (arrowheads) by an anechoic stripe, confirming the presence of a right-sided hemarthrosis and occult fracture. Abbreviation: PoCUS, point of care ultrasound. ",
"pubType": "image",
"copyright": "©Oxford University Press 2019. Caption may have been modified from original source.",
"format": "jpg",
"alt": "Right occult hip fracture. A patient with a history of non-weight-bearing right leg following a fall. Initial plain radiographs were inconclusive. PoCUS assessment demonstrated displacement of the joint capsule (arrowheads) by an anechoic stripe, confirming the presence of a right-sided hemarthrosis and occult fracture. Abbreviation: PoCUS, point of care ultrasound. ",
"links": [
{
"rel": "external",
"href": "https://media.ebsco.healthcare/eis-live/image/authenticated/t_media_lib_thumb/v1/EBSCOHealth/CCMS/Dynamed/images/I1677700339398.jpg?__cld_token__=exp=1769781909~hmac=cf4aef091e7120db037f598fa4239537456e34d1397a0fc9271f400ee4895197&_a=BAMAOGiu0",
"size": "small"
}
],
"telemetryData": {
"id": "I1677700339398",
"title": "Hip fracture identified by PoCUS",
"format": "jpg"
}
}
]
}
},
"recommendedQuestions": [],
"recommendedContent": {
"title": "Recommended Content",
"hasNotes": false,
"results": []
},
"followupQuestions": {
"title": "Ask a Follow-up",
"enabled": true
},
"telemetryData": {
"searchTerm": "fall risk",
"question": "How is fall risk assessed?",
"pageToken": "YYYY-MM-DD-GUID",
"conversationId": "YYYY-MM-DD-GUID",
"messageId": "0",
"searchTimeInMs": 78,
"ragResponseTimeInMs": 30794,
"userIntentTimeInMs": 580,
"answerFound": true,
"answerNotFound": false,
"userIntentCategory": "DH_ASSESSMENT",
"disclaimer": false
}
}
]
}Updated 1 day ago