@healthcloudai/hc-sdk 3.6.1 → 3.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +44 -0
- package/dist/index.d.cts +905 -30
- package/dist/index.d.ts +905 -30
- package/dist/index.js +44 -0
- package/docs/clients/OpenAIClient.md +1 -1
- package/docs/clients/ProviderClient.md +7 -0
- package/docs/docs-manifest.json +23 -4
- package/docs/examples/index.md +8 -1
- package/docs/index.md +8 -1
- package/docs/models/GetScanUploadUrlRequest.md +1 -1
- package/docs/models/OpenAIChatJsonRequest.md +1 -0
- package/docs/models/ProviderAppointment.md +24 -0
- package/docs/models/ProviderAppointmentResponse.md +17 -0
- package/docs/models/ProviderAppointmentsResponse.md +18 -0
- package/docs/models/ProviderEncounterListResponse.md +18 -0
- package/docs/models/ProviderEncounterResponse.md +17 -0
- package/docs/models/ProviderPatientAddress.md +22 -0
- package/docs/models/ProviderPatientPhone.md +19 -0
- package/docs/models/ProviderPatientRecordResponse.md +24 -0
- package/docs/models/ProviderPatientSummary.md +27 -0
- package/docs/models/UpdateEncounterClinicalNoteRequest.md +24 -0
- package/docs/models/UpdateEncounterClinicalNoteResponse.md +19 -0
- package/docs/models/UpdateEncounterStatusRequest.md +21 -0
- package/docs/models/UpdateEncounterStatusResponse.md +19 -0
- package/docs/models/index.md +13 -1
- package/docs/operations/connectors.athenaSearchAllergens.md +2 -2
- package/docs/operations/connectors.openaiChatJson.md +2 -2
- package/docs/operations/diagnostics.getScanUploadUrl.md +27 -11
- package/docs/operations/provider.getAppointment.md +148 -0
- package/docs/operations/provider.getEncounter.md +120 -0
- package/docs/operations/provider.getPatientRecord.md +122 -0
- package/docs/operations/provider.listAppointments.md +176 -0
- package/docs/operations/provider.listEncounters.md +123 -0
- package/docs/operations/provider.updateEncounterClinicalNote.md +154 -0
- package/docs/operations/provider.updateEncounterStatus.md +152 -0
- package/package.json +1 -1
- package/docs/models/AthenaSearchAllergensResponse.md +0 -15
package/dist/index.js
CHANGED
|
@@ -2866,6 +2866,50 @@ var ProviderClient = class extends BaseServiceClient {
|
|
|
2866
2866
|
connect() {
|
|
2867
2867
|
return this.connectService();
|
|
2868
2868
|
}
|
|
2869
|
+
/** List encounters in the authenticated provider's tenant. */
|
|
2870
|
+
listEncounters(filters) {
|
|
2871
|
+
return this.send("GET", "/encounters", { query: filters });
|
|
2872
|
+
}
|
|
2873
|
+
/** Get one encounter with its patient demographic summary. */
|
|
2874
|
+
getEncounter(encounterId) {
|
|
2875
|
+
return this.send("GET", "/encounters/{encounter_id}", { pathParams: { encounter_id: encounterId } });
|
|
2876
|
+
}
|
|
2877
|
+
/** Update the clinical note and assessment for one encounter. */
|
|
2878
|
+
updateEncounterClinicalNote(encounterId, request) {
|
|
2879
|
+
return this.send("PATCH", "/encounters/{encounter_id}/clinical-note", {
|
|
2880
|
+
pathParams: { encounter_id: encounterId },
|
|
2881
|
+
body: request
|
|
2882
|
+
});
|
|
2883
|
+
}
|
|
2884
|
+
/** Update canonical status; the server resolves any EHR status ID. */
|
|
2885
|
+
updateEncounterStatus(encounterId, request) {
|
|
2886
|
+
return this.send("PATCH", "/encounters/{encounter_id}/status", {
|
|
2887
|
+
pathParams: { encounter_id: encounterId },
|
|
2888
|
+
body: request
|
|
2889
|
+
});
|
|
2890
|
+
}
|
|
2891
|
+
/** List appointments in the authenticated provider's tenant.
|
|
2892
|
+
*
|
|
2893
|
+
* Date-window semantics (identical on the Athena and FHIR backends):
|
|
2894
|
+
* neither date -> today .. today+30d; only start_date -> start_date .. start_date+30d;
|
|
2895
|
+
* only end_date -> today .. end_date; legacy date pins exactly one calendar day.
|
|
2896
|
+
* The window is capped at 90 days and the result count at limit (default 100, max 200).
|
|
2897
|
+
*/
|
|
2898
|
+
listAppointments(filters) {
|
|
2899
|
+
return this.send("GET", "/appointments", { query: filters });
|
|
2900
|
+
}
|
|
2901
|
+
/** Get one appointment with its patient demographic summary. */
|
|
2902
|
+
getAppointment(appointmentId) {
|
|
2903
|
+
return this.send("GET", "/appointments/{appointment_id}", { pathParams: { appointment_id: appointmentId } });
|
|
2904
|
+
}
|
|
2905
|
+
/** Get a patient's consolidated health record (provider tenant scope). */
|
|
2906
|
+
getPatientRecord(patientId) {
|
|
2907
|
+
return this.send("GET", "/patients/{patient_id}/record", { pathParams: { patient_id: patientId } });
|
|
2908
|
+
}
|
|
2909
|
+
/** @deprecated Use listAppointments({ visit_type: "telehealth" }). */
|
|
2910
|
+
listTelehealthAppointments(filters) {
|
|
2911
|
+
return this.listAppointments({ ...filters, visit_type: "telehealth" });
|
|
2912
|
+
}
|
|
2869
2913
|
/** Submit multiple insurance eligibility checks for asynchronous processing. */
|
|
2870
2914
|
async submitInsuranceEligibilityBatch(request) {
|
|
2871
2915
|
const response = await this.send("POST", "/insurance/eligibility/batch", {
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
- [`buildResponseCreatePayload`](../operations/connectors.openaiBuildResponseCreatePayload.md) — Build a ``/v1/responses`` request body
|
|
4
4
|
- [`chat`](../operations/connectors.openaiChat.md) — Chat (OpenAI)
|
|
5
|
-
- [`chatJson`](../operations/connectors.openaiChatJson.md) — Chat
|
|
5
|
+
- [`chatJson`](../operations/connectors.openaiChatJson.md) — Return a JSON object from Chat Completions
|
|
6
6
|
- [`createAssistant`](../operations/connectors.openaiCreateAssistant.md) — Create a virtual agent profile and return its synthetic id
|
|
7
7
|
- [`deleteAssistant`](../operations/connectors.openaiDeleteAssistant.md) — Return whether there was a profile id to "delete"
|
|
8
8
|
- [`embed`](../operations/connectors.openaiEmbed.md) — Embed (OpenAI)
|
|
@@ -2,13 +2,20 @@
|
|
|
2
2
|
|
|
3
3
|
- [`confirmPassword`](../operations/provider.confirmResetPassword.md) — Complete a password reset
|
|
4
4
|
- [`connect`](../operations/provider.connect.md) — Health check
|
|
5
|
+
- [`getAppointment`](../operations/provider.getAppointment.md) — Get one appointment with patient demographics
|
|
6
|
+
- [`getEncounter`](../operations/provider.getEncounter.md) — Get one encounter with patient demographics
|
|
7
|
+
- [`getPatientRecord`](../operations/provider.getPatientRecord.md) — Get a patient's consolidated health record (provider tenant scope)
|
|
5
8
|
- [`getPhoto`](../operations/provider.getPhoto.md) — Get a practitioner photo
|
|
6
9
|
- [`getPhotoUploadUrl`](../operations/provider.getPhotoUploadUrl.md) — Get a presigned photo upload URL
|
|
7
10
|
- [`get`](../operations/provider.getPractitioner.md) — Get a practitioner profile
|
|
11
|
+
- [`listAppointments`](../operations/provider.listAppointments.md) — List tenant appointments
|
|
12
|
+
- [`listEncounters`](../operations/provider.listEncounters.md) — List tenant encounters
|
|
8
13
|
- [`login`](../operations/provider.login.md) — Log in a practitioner
|
|
9
14
|
- [`register`](../operations/provider.register.md) — Register a practitioner
|
|
10
15
|
- [`resetPassword`](../operations/provider.resetPassword.md) — Start a password reset
|
|
11
16
|
- [`submitInsuranceEligibilityBatch`](../operations/provider.submitInsuranceEligibilityBatch.md) — Submit multiple insurance eligibility checks
|
|
17
|
+
- [`updateEncounterClinicalNote`](../operations/provider.updateEncounterClinicalNote.md) — Update encounter notes and assessment
|
|
18
|
+
- [`updateEncounterStatus`](../operations/provider.updateEncounterStatus.md) — Update encounter status
|
|
12
19
|
- [`updatePhone`](../operations/provider.updatePhone.md) — Update a practitioner's phone number
|
|
13
20
|
- [`update`](../operations/provider.updatePractitioner.md) — Update a practitioner profile
|
|
14
21
|
- [`uploadPhoto`](../operations/provider.uploadPhoto.md) — Upload a practitioner photo
|
package/docs/docs-manifest.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"docsDataContentDigest": "sha256:
|
|
2
|
+
"docsDataContentDigest": "sha256:d1c85b32580d5848c836408f23934c89d174927bee1ee7b4a44fef1ec304e227",
|
|
3
3
|
"generatedFiles": [
|
|
4
4
|
"authentication.md",
|
|
5
5
|
"clients/AmsClient.md",
|
|
@@ -331,7 +331,6 @@
|
|
|
331
331
|
"models/AthenaRetrieveAvailableAppointmentSlotsRequest.md",
|
|
332
332
|
"models/AthenaReviewOfSystems.md",
|
|
333
333
|
"models/AthenaSearchAllergensRequest.md",
|
|
334
|
-
"models/AthenaSearchAllergensResponse.md",
|
|
335
334
|
"models/AthenaSearchClinicalProvidersRequest.md",
|
|
336
335
|
"models/AthenaSearchMedicationsRequest.md",
|
|
337
336
|
"models/AthenaSearchMedicationsResponse.md",
|
|
@@ -1374,12 +1373,21 @@
|
|
|
1374
1373
|
"models/ProcedureLaterality.md",
|
|
1375
1374
|
"models/ProcedureStatus.md",
|
|
1376
1375
|
"models/ProviderAcceptedInsurance.md",
|
|
1376
|
+
"models/ProviderAppointment.md",
|
|
1377
|
+
"models/ProviderAppointmentResponse.md",
|
|
1378
|
+
"models/ProviderAppointmentsResponse.md",
|
|
1377
1379
|
"models/ProviderContactPoint.md",
|
|
1378
1380
|
"models/ProviderEducationCredential.md",
|
|
1381
|
+
"models/ProviderEncounterListResponse.md",
|
|
1382
|
+
"models/ProviderEncounterResponse.md",
|
|
1379
1383
|
"models/ProviderGender.md",
|
|
1380
1384
|
"models/ProviderIdentifier.md",
|
|
1381
1385
|
"models/ProviderIdentifierType.md",
|
|
1382
1386
|
"models/ProviderLanguage.md",
|
|
1387
|
+
"models/ProviderPatientAddress.md",
|
|
1388
|
+
"models/ProviderPatientPhone.md",
|
|
1389
|
+
"models/ProviderPatientRecordResponse.md",
|
|
1390
|
+
"models/ProviderPatientSummary.md",
|
|
1383
1391
|
"models/ProviderRole.md",
|
|
1384
1392
|
"models/ProviderSearchRequest.md",
|
|
1385
1393
|
"models/ProviderSearchResponse.md",
|
|
@@ -1777,6 +1785,10 @@
|
|
|
1777
1785
|
"models/UpdateDemographicsResponse.md",
|
|
1778
1786
|
"models/UpdateDriversLicenseRequest.md",
|
|
1779
1787
|
"models/UpdateDriversLicenseResponse.md",
|
|
1788
|
+
"models/UpdateEncounterClinicalNoteRequest.md",
|
|
1789
|
+
"models/UpdateEncounterClinicalNoteResponse.md",
|
|
1790
|
+
"models/UpdateEncounterStatusRequest.md",
|
|
1791
|
+
"models/UpdateEncounterStatusResponse.md",
|
|
1780
1792
|
"models/UpdateMedicationRequest.md",
|
|
1781
1793
|
"models/UpdateMedicationResponse.md",
|
|
1782
1794
|
"models/UpdatePatientAttributesRequest.md",
|
|
@@ -3061,13 +3073,20 @@
|
|
|
3061
3073
|
"operations/person.verifySms.md",
|
|
3062
3074
|
"operations/provider.confirmResetPassword.md",
|
|
3063
3075
|
"operations/provider.connect.md",
|
|
3076
|
+
"operations/provider.getAppointment.md",
|
|
3077
|
+
"operations/provider.getEncounter.md",
|
|
3078
|
+
"operations/provider.getPatientRecord.md",
|
|
3064
3079
|
"operations/provider.getPhoto.md",
|
|
3065
3080
|
"operations/provider.getPhotoUploadUrl.md",
|
|
3066
3081
|
"operations/provider.getPractitioner.md",
|
|
3082
|
+
"operations/provider.listAppointments.md",
|
|
3083
|
+
"operations/provider.listEncounters.md",
|
|
3067
3084
|
"operations/provider.login.md",
|
|
3068
3085
|
"operations/provider.register.md",
|
|
3069
3086
|
"operations/provider.resetPassword.md",
|
|
3070
3087
|
"operations/provider.submitInsuranceEligibilityBatch.md",
|
|
3088
|
+
"operations/provider.updateEncounterClinicalNote.md",
|
|
3089
|
+
"operations/provider.updateEncounterStatus.md",
|
|
3071
3090
|
"operations/provider.updatePhone.md",
|
|
3072
3091
|
"operations/provider.updatePractitioner.md",
|
|
3073
3092
|
"operations/provider.uploadPhoto.md",
|
|
@@ -3084,7 +3103,7 @@
|
|
|
3084
3103
|
"operations/vitals.recordVitals.md"
|
|
3085
3104
|
],
|
|
3086
3105
|
"language": "nodejs",
|
|
3087
|
-
"modelCount":
|
|
3088
|
-
"operationCount":
|
|
3106
|
+
"modelCount": 2022,
|
|
3107
|
+
"operationCount": 1024,
|
|
3089
3108
|
"schemaVersion": 1
|
|
3090
3109
|
}
|
package/docs/examples/index.md
CHANGED
|
@@ -535,7 +535,7 @@ Generated call examples use exact public surface signatures. Workflow examples r
|
|
|
535
535
|
- [Verify a provider's NPI against the NPI Registry](../operations/connectors.nppesVerifyProvider.md)
|
|
536
536
|
- [Build a ``/v1/responses`` request body](../operations/connectors.openaiBuildResponseCreatePayload.md)
|
|
537
537
|
- [Chat (OpenAI)](../operations/connectors.openaiChat.md)
|
|
538
|
-
- [Chat
|
|
538
|
+
- [Return a JSON object from Chat Completions](../operations/connectors.openaiChatJson.md)
|
|
539
539
|
- [Create a virtual agent profile and return its synthetic id](../operations/connectors.openaiCreateAssistant.md)
|
|
540
540
|
- [Return whether there was a profile id to "delete"](../operations/connectors.openaiDeleteAssistant.md)
|
|
541
541
|
- [Embed (OpenAI)](../operations/connectors.openaiEmbed.md)
|
|
@@ -998,13 +998,20 @@ Generated call examples use exact public surface signatures. Workflow examples r
|
|
|
998
998
|
- [Verify a person's phone OTP](../operations/person.verifySms.md)
|
|
999
999
|
- [Complete a password reset](../operations/provider.confirmResetPassword.md)
|
|
1000
1000
|
- [Health check](../operations/provider.connect.md)
|
|
1001
|
+
- [Get one appointment with patient demographics](../operations/provider.getAppointment.md)
|
|
1002
|
+
- [Get one encounter with patient demographics](../operations/provider.getEncounter.md)
|
|
1003
|
+
- [Get a patient's consolidated health record (provider tenant scope)](../operations/provider.getPatientRecord.md)
|
|
1001
1004
|
- [Get a practitioner photo](../operations/provider.getPhoto.md)
|
|
1002
1005
|
- [Get a presigned photo upload URL](../operations/provider.getPhotoUploadUrl.md)
|
|
1003
1006
|
- [Get a practitioner profile](../operations/provider.getPractitioner.md)
|
|
1007
|
+
- [List tenant appointments](../operations/provider.listAppointments.md)
|
|
1008
|
+
- [List tenant encounters](../operations/provider.listEncounters.md)
|
|
1004
1009
|
- [Log in a practitioner](../operations/provider.login.md)
|
|
1005
1010
|
- [Register a practitioner](../operations/provider.register.md)
|
|
1006
1011
|
- [Start a password reset](../operations/provider.resetPassword.md)
|
|
1007
1012
|
- [Submit multiple insurance eligibility checks](../operations/provider.submitInsuranceEligibilityBatch.md)
|
|
1013
|
+
- [Update encounter notes and assessment](../operations/provider.updateEncounterClinicalNote.md)
|
|
1014
|
+
- [Update encounter status](../operations/provider.updateEncounterStatus.md)
|
|
1008
1015
|
- [Update a practitioner's phone number](../operations/provider.updatePhone.md)
|
|
1009
1016
|
- [Update a practitioner profile](../operations/provider.updatePractitioner.md)
|
|
1010
1017
|
- [Upload a practitioner photo](../operations/provider.uploadPhoto.md)
|
package/docs/index.md
CHANGED
|
@@ -543,7 +543,7 @@ This directory is generated from the shared structured docs data. Do not edit ge
|
|
|
543
543
|
- [Verify a provider's NPI against the NPI Registry](operations/connectors.nppesVerifyProvider.md) (`connectors.nppesVerifyProvider`)
|
|
544
544
|
- [Build a ``/v1/responses`` request body](operations/connectors.openaiBuildResponseCreatePayload.md) (`connectors.openaiBuildResponseCreatePayload`)
|
|
545
545
|
- [Chat (OpenAI)](operations/connectors.openaiChat.md) (`connectors.openaiChat`)
|
|
546
|
-
- [Chat
|
|
546
|
+
- [Return a JSON object from Chat Completions](operations/connectors.openaiChatJson.md) (`connectors.openaiChatJson`)
|
|
547
547
|
- [Create a virtual agent profile and return its synthetic id](operations/connectors.openaiCreateAssistant.md) (`connectors.openaiCreateAssistant`)
|
|
548
548
|
- [Return whether there was a profile id to "delete"](operations/connectors.openaiDeleteAssistant.md) (`connectors.openaiDeleteAssistant`)
|
|
549
549
|
- [Embed (OpenAI)](operations/connectors.openaiEmbed.md) (`connectors.openaiEmbed`)
|
|
@@ -1006,13 +1006,20 @@ This directory is generated from the shared structured docs data. Do not edit ge
|
|
|
1006
1006
|
- [Verify a person's phone OTP](operations/person.verifySms.md) (`person.verifySms`)
|
|
1007
1007
|
- [Complete a password reset](operations/provider.confirmResetPassword.md) (`provider.confirmResetPassword`)
|
|
1008
1008
|
- [Health check](operations/provider.connect.md) (`provider.connect`)
|
|
1009
|
+
- [Get one appointment with patient demographics](operations/provider.getAppointment.md) (`provider.getAppointment`)
|
|
1010
|
+
- [Get one encounter with patient demographics](operations/provider.getEncounter.md) (`provider.getEncounter`)
|
|
1011
|
+
- [Get a patient's consolidated health record (provider tenant scope)](operations/provider.getPatientRecord.md) (`provider.getPatientRecord`)
|
|
1009
1012
|
- [Get a practitioner photo](operations/provider.getPhoto.md) (`provider.getPhoto`)
|
|
1010
1013
|
- [Get a presigned photo upload URL](operations/provider.getPhotoUploadUrl.md) (`provider.getPhotoUploadUrl`)
|
|
1011
1014
|
- [Get a practitioner profile](operations/provider.getPractitioner.md) (`provider.getPractitioner`)
|
|
1015
|
+
- [List tenant appointments](operations/provider.listAppointments.md) (`provider.listAppointments`)
|
|
1016
|
+
- [List tenant encounters](operations/provider.listEncounters.md) (`provider.listEncounters`)
|
|
1012
1017
|
- [Log in a practitioner](operations/provider.login.md) (`provider.login`)
|
|
1013
1018
|
- [Register a practitioner](operations/provider.register.md) (`provider.register`)
|
|
1014
1019
|
- [Start a password reset](operations/provider.resetPassword.md) (`provider.resetPassword`)
|
|
1015
1020
|
- [Submit multiple insurance eligibility checks](operations/provider.submitInsuranceEligibilityBatch.md) (`provider.submitInsuranceEligibilityBatch`)
|
|
1021
|
+
- [Update encounter notes and assessment](operations/provider.updateEncounterClinicalNote.md) (`provider.updateEncounterClinicalNote`)
|
|
1022
|
+
- [Update encounter status](operations/provider.updateEncounterStatus.md) (`provider.updateEncounterStatus`)
|
|
1016
1023
|
- [Update a practitioner's phone number](operations/provider.updatePhone.md) (`provider.updatePhone`)
|
|
1017
1024
|
- [Update a practitioner profile](operations/provider.updatePractitioner.md) (`provider.updatePractitioner`)
|
|
1018
1025
|
- [Upload a practitioner photo](operations/provider.uploadPhoto.md) (`provider.uploadPhoto`)
|
|
@@ -13,7 +13,7 @@ Type: `object`
|
|
|
13
13
|
| `content_type` | `string` | No | | | `"image/jpeg"` | No | MIME type of the scan image. Defaults to image/jpeg. |
|
|
14
14
|
| `encounter_id` | `string|null` | No | | | | Yes | FHIR Encounter id this scan is associated with, optional. Stored on the pending Observation so the async SAFE CDX result ingestion can mirror the finished result to Athena (when the tenant/patient are Athena-linked) once CVML processing completes. |
|
|
15
15
|
| `filename` | `string` | No | | | `"scan.jpg"` | No | Filename of the uploaded scan. Defaults to scan.jpg. |
|
|
16
|
-
| `gtin` | `string
|
|
16
|
+
| `gtin` | `string` | Yes | | | | No | GTIN of the scanned test kit (8, 12, 13, or 14 digits, normalized to zero-padded GTIN-14). Must resolve to a configured test profile — unrecognized GTINs get a 404, and no product default exists. |
|
|
17
17
|
| `test_id` | `string` | Yes | uuid | | | No | Health Cloud correlation UUID for the diagnostic scan. |
|
|
18
18
|
|
|
19
19
|
## Example
|
|
@@ -17,6 +17,7 @@ Type: `object`
|
|
|
17
17
|
| `mode` | `string` | No | | sandbox, live | `"sandbox"` | No | Which vendor environment the call is routed to. Defaults to sandbox, so an omitted mode never reaches a production vendor account. |
|
|
18
18
|
| `model` | `string` | No | | | | Yes | |
|
|
19
19
|
| `organization` | `string` | No | | | | Yes | |
|
|
20
|
+
| `system` | `string` | No | | | | Yes | |
|
|
20
21
|
|
|
21
22
|
## Example
|
|
22
23
|
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# ProviderAppointment
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderAppointment`
|
|
4
|
+
|
|
5
|
+
Source-neutral appointment returned to a provider.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `appointment_id` | `string` | Yes | | | | No | Stable appointment identifier; Athena-authoritative tenants return Athena's native appointment ID. |
|
|
14
|
+
| `end` | `string|null` | No | | | | Yes | Appointment end in ISO 8601 date-time format. |
|
|
15
|
+
| `patient` | [`ProviderPatientSummary`](./ProviderPatientSummary.md) | No | | | | Yes | Demographic snapshot (first/last name, gender, DOB, address, phone) of the associated patient. On list responses, only the first 20 items carry a summary; by-ID responses always include it when readable. |
|
|
16
|
+
| `patient_id` | `string` | Yes | | | | No | FHIR Patient resource ID associated with the appointment. |
|
|
17
|
+
| `provider_id` | `string|null` | No | | | | Yes | FHIR Practitioner resource ID, when available. |
|
|
18
|
+
| `start` | `string|null` | No | | | | Yes | Appointment start in ISO 8601 date-time format. |
|
|
19
|
+
| `status` | `string` | Yes | | scheduled, confirmed, cancelled, completed, no_show | | No | Normalized appointment lifecycle status. |
|
|
20
|
+
| `telehealth_link` | `string|null` | No | | | | Yes | Video-visit link, when one has been created for this appointment. |
|
|
21
|
+
|
|
22
|
+
## Example
|
|
23
|
+
|
|
24
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ProviderAppointmentResponse
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderAppointmentResponse`
|
|
4
|
+
|
|
5
|
+
One appointment returned to an authenticated provider.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `appointment` | [`ProviderAppointment`](./ProviderAppointment.md) | Yes | | | | No | The requested appointment, including its patient demographic summary. |
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# ProviderAppointmentsResponse
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderAppointmentsResponse`
|
|
4
|
+
|
|
5
|
+
Tenant appointments in one HealthCloud shape.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `appointments` | array of [`ProviderAppointment`](./ProviderAppointment.md) | Yes | | | | No | Appointments for the requested filters; the first 20 items include a patient demographic summary when the tenant's FHIR Patient record is readable. |
|
|
14
|
+
| `total` | `integer` | Yes | | | | No | Number of appointments returned. |
|
|
15
|
+
|
|
16
|
+
## Example
|
|
17
|
+
|
|
18
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# ProviderEncounterListResponse
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderEncounterListResponse`
|
|
4
|
+
|
|
5
|
+
Tenant-scoped encounter list returned to an authenticated provider.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `encounters` | `array` | Yes | | | | No | FHIR-backed encounter records in the caller's tenant; the first 20 items also carry a patient demographic summary under the 'patient' key when the tenant's FHIR Patient record is readable. |
|
|
14
|
+
| `total` | `integer` | Yes | | | | No | Number of encounter records returned. |
|
|
15
|
+
|
|
16
|
+
## Example
|
|
17
|
+
|
|
18
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ProviderEncounterResponse
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderEncounterResponse`
|
|
4
|
+
|
|
5
|
+
One encounter returned to an authenticated provider.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `encounter` | `object` | Yes | | | | No | FHIR-backed encounter record with a patient demographic summary under the 'patient' key when the tenant's FHIR Patient record is readable. |
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# ProviderPatientAddress
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderPatientAddress`
|
|
4
|
+
|
|
5
|
+
Primary address snapshot returned inside a provider patient summary.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `city` | `string|null` | No | | | | Yes | City in the address. |
|
|
14
|
+
| `country` | `string|null` | No | | | | Yes | ISO 3166-1 alpha-2 country code. |
|
|
15
|
+
| `state` | `string|null` | No | | | | Yes | 2-letter US state code. |
|
|
16
|
+
| `street1` | `string|null` | No | | | | Yes | First address line (street number and name). |
|
|
17
|
+
| `street2` | `string|null` | No | | | | Yes | Second address line (apartment, suite, unit), when present. |
|
|
18
|
+
| `zip_code` | `string|null` | No | | | | Yes | US ZIP code (5 or 9 digits). |
|
|
19
|
+
|
|
20
|
+
## Example
|
|
21
|
+
|
|
22
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# ProviderPatientPhone
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderPatientPhone`
|
|
4
|
+
|
|
5
|
+
Primary phone snapshot returned inside a provider patient summary.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `extension` | `string|null` | No | | | | Yes | Phone extension, when present. |
|
|
14
|
+
| `number` | `string|null` | No | | | | Yes | Phone number in E.164 or 10-15 digit format. |
|
|
15
|
+
| `type` | `string|null` | No | | | | Yes | Phone use: mobile, home, or work. |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# ProviderPatientRecordResponse
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderPatientRecordResponse`
|
|
4
|
+
|
|
5
|
+
Consolidated health record for one patient in the provider's own tenant.
|
|
6
|
+
|
|
7
|
+
Mirrors the shape of the patient-facing EHR health-record response so
|
|
8
|
+
provider clients see the same section keys and serialized domain models.
|
|
9
|
+
A patient that does not exist in the caller's tenant resolves to 404
|
|
10
|
+
before this response is produced.
|
|
11
|
+
|
|
12
|
+
Type: `object`
|
|
13
|
+
|
|
14
|
+
## Fields
|
|
15
|
+
|
|
16
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
17
|
+
|---|---|---:|---|---|---|---:|---|
|
|
18
|
+
| `patient_id` | `string` | Yes | | | | No | Echoes the {patient_id} path parameter. |
|
|
19
|
+
| `resources` | `object` | Yes | | | | No | Resources grouped by type (conditions, allergies, medications, procedures, immunizations, family_history, consents, social_history, functional_status, gyn_history, perinatal_history, encounters, vitals, questionnaire_responses, diagnostics, intake_submissions) — every section is a serialized domain model, never a raw FHIR resource. Vitals is the latest-reading VitalsRecord summary per LOINC code. A resource type with a failed downstream fetch appears as an empty list, not an error. |
|
|
20
|
+
| `totals` | `object` | Yes | | | | No | Count of records per resource type key in `resources`. |
|
|
21
|
+
|
|
22
|
+
## Example
|
|
23
|
+
|
|
24
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# ProviderPatientSummary
|
|
2
|
+
|
|
3
|
+
Model ID: `ProviderPatientSummary`
|
|
4
|
+
|
|
5
|
+
Demographic snapshot attached to appointments and encounters.
|
|
6
|
+
|
|
7
|
+
Built from the tenant's own FHIR Patient record; when the patient record
|
|
8
|
+
cannot be read, the summary is omitted rather than failing the whole
|
|
9
|
+
request.
|
|
10
|
+
|
|
11
|
+
Type: `object`
|
|
12
|
+
|
|
13
|
+
## Fields
|
|
14
|
+
|
|
15
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
16
|
+
|---|---|---:|---|---|---|---:|---|
|
|
17
|
+
| `address` | [`ProviderPatientAddress`](./ProviderPatientAddress.md) | No | | | | Yes | Patient's primary address, when recorded. |
|
|
18
|
+
| `date_of_birth` | `string|null` | No | | | | Yes | Patient's date of birth in ISO date format. |
|
|
19
|
+
| `first_name` | `string|null` | No | | | | Yes | Patient's first (given) name. |
|
|
20
|
+
| `gender` | `string|null` | No | | | | Yes | Administrative gender: male, female, other, or unknown. |
|
|
21
|
+
| `last_name` | `string|null` | No | | | | Yes | Patient's last (family) name. |
|
|
22
|
+
| `patient_id` | `string` | Yes | | | | No | FHIR Patient resource ID. |
|
|
23
|
+
| `phone` | [`ProviderPatientPhone`](./ProviderPatientPhone.md) | No | | | | Yes | Patient's primary phone number, when recorded. |
|
|
24
|
+
|
|
25
|
+
## Example
|
|
26
|
+
|
|
27
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UpdateEncounterClinicalNoteRequest
|
|
2
|
+
|
|
3
|
+
Model ID: `UpdateEncounterClinicalNoteRequest`
|
|
4
|
+
|
|
5
|
+
FHIR notes and/or clinical assessment for one encounter.
|
|
6
|
+
|
|
7
|
+
The FHIR Encounter stores the submitted content in its notes extension.
|
|
8
|
+
When the encounter is linked to the configured EHR, ``notes`` is written
|
|
9
|
+
to the EHR SOAP subjective field and ``assessment`` to its SOAP assessment
|
|
10
|
+
field. At least one field must be supplied; the handler enforces that
|
|
11
|
+
cross-field rule.
|
|
12
|
+
|
|
13
|
+
Type: `object`
|
|
14
|
+
|
|
15
|
+
## Fields
|
|
16
|
+
|
|
17
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
18
|
+
|---|---|---:|---|---|---|---:|---|
|
|
19
|
+
| `assessment` | `string|null` | No | | | | Yes | Clinical assessment; mirrored to the linked EHR SOAP assessment field when available. |
|
|
20
|
+
| `notes` | `string|null` | No | | | | Yes | Encounter notes; mirrored to the linked EHR SOAP subjective field when available. |
|
|
21
|
+
|
|
22
|
+
## Example
|
|
23
|
+
|
|
24
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# UpdateEncounterClinicalNoteResponse
|
|
2
|
+
|
|
3
|
+
Model ID: `UpdateEncounterClinicalNoteResponse`
|
|
4
|
+
|
|
5
|
+
Result of a FHIR clinical-note update and conditional EHR mirror.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `ehr_status` | `string` | Yes | | updated, not_linked | | No | Whether a linked EHR encounter was updated too. |
|
|
14
|
+
| `encounter` | `object` | Yes | | | | No | Updated FHIR encounter. |
|
|
15
|
+
| `fhir_status` | `string` | Yes | | | | No | FHIR update completed. |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# UpdateEncounterStatusRequest
|
|
2
|
+
|
|
3
|
+
Model ID: `UpdateEncounterStatusRequest`
|
|
4
|
+
|
|
5
|
+
Set one encounter's HealthCloud and configured EHR statuses.
|
|
6
|
+
|
|
7
|
+
The server resolves any vendor-specific status/location IDs from the
|
|
8
|
+
tenant's EHR integration configuration. Provider clients submit only the
|
|
9
|
+
canonical HealthCloud status and never see or store vendor IDs.
|
|
10
|
+
|
|
11
|
+
Type: `object`
|
|
12
|
+
|
|
13
|
+
## Fields
|
|
14
|
+
|
|
15
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
16
|
+
|---|---|---:|---|---|---|---:|---|
|
|
17
|
+
| `status` | `string` | Yes | | | | No | HealthCloud encounter status to persist in FHIR. |
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
|
|
21
|
+
None declared in canonical OpenAPI.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# UpdateEncounterStatusResponse
|
|
2
|
+
|
|
3
|
+
Model ID: `UpdateEncounterStatusResponse`
|
|
4
|
+
|
|
5
|
+
Result of a FHIR encounter-status update and conditional EHR mirror.
|
|
6
|
+
|
|
7
|
+
Type: `object`
|
|
8
|
+
|
|
9
|
+
## Fields
|
|
10
|
+
|
|
11
|
+
| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
12
|
+
|---|---|---:|---|---|---|---:|---|
|
|
13
|
+
| `ehr_status` | `string` | Yes | | updated, not_linked, skipped | | No | Whether a linked EHR encounter was updated too. 'skipped' means the encounter is linked but this HealthCloud status has no flow-board equivalent, so only FHIR was updated. |
|
|
14
|
+
| `encounter` | `object` | Yes | | | | No | Updated FHIR encounter. |
|
|
15
|
+
| `fhir_status` | `string` | Yes | | | | No | FHIR update completed. |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
None declared in canonical OpenAPI.
|
package/docs/models/index.md
CHANGED
|
@@ -282,7 +282,6 @@
|
|
|
282
282
|
- [AthenaRetrieveAvailableAppointmentSlotsRequest](AthenaRetrieveAvailableAppointmentSlotsRequest.md)
|
|
283
283
|
- [AthenaReviewOfSystems](AthenaReviewOfSystems.md)
|
|
284
284
|
- [AthenaSearchAllergensRequest](AthenaSearchAllergensRequest.md)
|
|
285
|
-
- [AthenaSearchAllergensResponse](AthenaSearchAllergensResponse.md)
|
|
286
285
|
- [AthenaSearchClinicalProvidersRequest](AthenaSearchClinicalProvidersRequest.md)
|
|
287
286
|
- [AthenaSearchMedicationsRequest](AthenaSearchMedicationsRequest.md)
|
|
288
287
|
- [AthenaSearchMedicationsResponse](AthenaSearchMedicationsResponse.md)
|
|
@@ -1440,12 +1439,21 @@
|
|
|
1440
1439
|
- [ProviderVerifySmsRequest](provider.VerifySmsRequest.md)
|
|
1441
1440
|
- [ProviderVerifySmsResponse](provider.VerifySmsResponse.md)
|
|
1442
1441
|
- [ProviderAcceptedInsurance](ProviderAcceptedInsurance.md)
|
|
1442
|
+
- [ProviderAppointment](ProviderAppointment.md)
|
|
1443
|
+
- [ProviderAppointmentResponse](ProviderAppointmentResponse.md)
|
|
1444
|
+
- [ProviderAppointmentsResponse](ProviderAppointmentsResponse.md)
|
|
1443
1445
|
- [ProviderContactPoint](ProviderContactPoint.md)
|
|
1444
1446
|
- [ProviderEducationCredential](ProviderEducationCredential.md)
|
|
1447
|
+
- [ProviderEncounterListResponse](ProviderEncounterListResponse.md)
|
|
1448
|
+
- [ProviderEncounterResponse](ProviderEncounterResponse.md)
|
|
1445
1449
|
- [ProviderGender](ProviderGender.md)
|
|
1446
1450
|
- [ProviderIdentifier](ProviderIdentifier.md)
|
|
1447
1451
|
- [ProviderIdentifierType](ProviderIdentifierType.md)
|
|
1448
1452
|
- [ProviderLanguage](ProviderLanguage.md)
|
|
1453
|
+
- [ProviderPatientAddress](ProviderPatientAddress.md)
|
|
1454
|
+
- [ProviderPatientPhone](ProviderPatientPhone.md)
|
|
1455
|
+
- [ProviderPatientRecordResponse](ProviderPatientRecordResponse.md)
|
|
1456
|
+
- [ProviderPatientSummary](ProviderPatientSummary.md)
|
|
1449
1457
|
- [ProviderRole](ProviderRole.md)
|
|
1450
1458
|
- [ProviderSearchRequest](ProviderSearchRequest.md)
|
|
1451
1459
|
- [ProviderSearchResponse](ProviderSearchResponse.md)
|
|
@@ -1847,6 +1855,10 @@
|
|
|
1847
1855
|
- [UpdateDemographicsResponse](UpdateDemographicsResponse.md)
|
|
1848
1856
|
- [UpdateDriversLicenseRequest](UpdateDriversLicenseRequest.md)
|
|
1849
1857
|
- [UpdateDriversLicenseResponse](UpdateDriversLicenseResponse.md)
|
|
1858
|
+
- [UpdateEncounterClinicalNoteRequest](UpdateEncounterClinicalNoteRequest.md)
|
|
1859
|
+
- [UpdateEncounterClinicalNoteResponse](UpdateEncounterClinicalNoteResponse.md)
|
|
1860
|
+
- [UpdateEncounterStatusRequest](UpdateEncounterStatusRequest.md)
|
|
1861
|
+
- [UpdateEncounterStatusResponse](UpdateEncounterStatusResponse.md)
|
|
1850
1862
|
- [UpdateMedicationRequest](UpdateMedicationRequest.md)
|
|
1851
1863
|
- [UpdateMedicationResponse](UpdateMedicationResponse.md)
|
|
1852
1864
|
- [UpdatePatientAttributesRequest](UpdatePatientAttributesRequest.md)
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Operation ID: `connectors.athenaSearchAllergens`
|
|
4
4
|
|
|
5
|
-
Search Athena's allergen reference list. Returns a stable connector-facing shape: [{"allergen_id": "...", "allergen_name": "..."}]
|
|
5
|
+
Search Athena's allergen reference list. Returns a stable connector-facing shape: [{"allergen_id": "...", "allergen_name": "..."}] Athena's allergen catalogue search is case-sensitive and does not stem plural forms: ``Peanuts`` and ``peanuts`` match nothing while ``peanut`` does. An empty first pass therefore retries the lowercased phrase and a singular form, mirroring the established intake.py catalogue fallback, so patient-typed plurals still reach the catalogue candidates the AI ranking needs.
|
|
6
6
|
|
|
7
7
|
## Public method
|
|
8
8
|
|
|
@@ -59,7 +59,7 @@ Request model: [`AthenaSearchAllergensRequest`](../models/AthenaSearchAllergensR
|
|
|
59
59
|
|
|
60
60
|
| Status | Shape | Content type | Description |
|
|
61
61
|
|---|---|---|---|
|
|
62
|
-
| `200` | [`
|
|
62
|
+
| `200` | [`connectors.JsonValue`](../models/connectors.JsonValue.md) | application/json | Successful response |
|
|
63
63
|
|
|
64
64
|
## Success response examples
|
|
65
65
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# Chat
|
|
1
|
+
# Return a JSON object from Chat Completions
|
|
2
2
|
|
|
3
3
|
Operation ID: `connectors.openaiChatJson`
|
|
4
4
|
|
|
5
|
-
Chat
|
|
5
|
+
Return a JSON object from Chat Completions. ``system`` is an application-level convenience argument, like it is for :meth:`chat`. Chat Completions accepts system instructions as a message, not as a top-level request property. Keeping it out of ``kwargs`` prevents a 400 response that otherwise looks like an empty AI ranking to intake callers.
|
|
6
6
|
|
|
7
7
|
## Public method
|
|
8
8
|
|