{ "version":"2.0", "metadata":{ "apiVersion":"2025-01-29", "auth":["aws.auth#sigv4"], "endpointPrefix":"health-agent", "protocol":"rest-json", "protocolSettings":{"h2":"eventstream"}, "protocols":["rest-json"], "serviceFullName":"Connect Health", "serviceId":"ConnectHealth", "signatureVersion":"v4", "signingName":"health-agent", "uid":"connecthealth-2025-01-29" }, "operations":{ "ActivateSubscription":{ "name":"ActivateSubscription", "http":{ "method":"POST", "requestUri":"/domains/{domainId}/subscriptions/{subscriptionId}/activate", "responseCode":200 }, "input":{"shape":"ActivateSubscriptionInput"}, "output":{"shape":"ActivateSubscriptionOutput"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"} ], "documentation":"
Activates a Subscription to enable billing for a user.
" }, "CreateDomain":{ "name":"CreateDomain", "http":{ "method":"POST", "requestUri":"/domain", "responseCode":201 }, "input":{"shape":"CreateDomainInput"}, "output":{"shape":"CreateDomainOutput"}, "errors":[ {"shape":"ServiceQuotaExceededException"} ], "documentation":"Creates a new Domain for managing HealthAgent resources.
", "idempotent":true }, "CreateSubscription":{ "name":"CreateSubscription", "http":{ "method":"POST", "requestUri":"/domains/{domainId}/subscriptions", "responseCode":201 }, "input":{"shape":"CreateSubscriptionInput"}, "output":{"shape":"CreateSubscriptionOutput"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ServiceQuotaExceededException"} ], "documentation":"Creates a new Subscription within a Domain for billing and user management.
" }, "DeactivateSubscription":{ "name":"DeactivateSubscription", "http":{ "method":"POST", "requestUri":"/domains/{domainId}/subscriptions/{subscriptionId}/deactivate", "responseCode":200 }, "input":{"shape":"DeactivateSubscriptionInput"}, "output":{"shape":"DeactivateSubscriptionOutput"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"} ], "documentation":"Deactivates a Subscription to stop billing for a user.
", "idempotent":true }, "DeleteDomain":{ "name":"DeleteDomain", "http":{ "method":"DELETE", "requestUri":"/domain/{domainId}", "responseCode":200 }, "input":{"shape":"DeleteDomainInput"}, "output":{"shape":"DeleteDomainOutput"}, "errors":[ {"shape":"ResourceNotFoundException"} ], "documentation":"Deletes a Domain and all associated resources.
", "idempotent":true }, "GetDomain":{ "name":"GetDomain", "http":{ "method":"GET", "requestUri":"/domain/{domainId}", "responseCode":200 }, "input":{"shape":"GetDomainInput"}, "output":{"shape":"GetDomainOutput"}, "errors":[ {"shape":"ResourceNotFoundException"} ], "documentation":"Retrieves information about a Domain.
", "readonly":true }, "GetMedicalScribeListeningSession":{ "name":"GetMedicalScribeListeningSession", "http":{ "method":"GET", "requestUri":"/medical-scribe-stream/domain/{domainId}/subscription/{subscriptionId}/session/{sessionId}", "responseCode":200 }, "input":{"shape":"GetMedicalScribeListeningSessionInput"}, "output":{"shape":"GetMedicalScribeListeningSessionOutput"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ServiceQuotaExceededException"} ], "documentation":"Retrieves details about an existing Medical Scribe listening session
", "endpoint":{"hostPrefix":"streaming."}, "readonly":true }, "GetPatientInsightsJob":{ "name":"GetPatientInsightsJob", "http":{ "method":"GET", "requestUri":"/domain/{domainId}/patient-insights-job/{jobId}", "responseCode":200 }, "input":{"shape":"GetPatientInsightsJobRequest"}, "output":{"shape":"GetPatientInsightsJobResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"Get details of a started patient insights job.
", "endpoint":{"hostPrefix":"runtime."}, "readonly":true }, "GetSubscription":{ "name":"GetSubscription", "http":{ "method":"GET", "requestUri":"/domains/{domainId}/subscriptions/{subscriptionId}", "responseCode":200 }, "input":{"shape":"GetSubscriptionInput"}, "output":{"shape":"GetSubscriptionOutput"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"} ], "documentation":"Retrieves information about a Subscription.
", "readonly":true }, "ListDomains":{ "name":"ListDomains", "http":{ "method":"GET", "requestUri":"/domain", "responseCode":200 }, "input":{"shape":"ListDomainsInput"}, "output":{"shape":"ListDomainsOutput"}, "documentation":"Lists Domains for a given account.
", "readonly":true }, "ListSubscriptions":{ "name":"ListSubscriptions", "http":{ "method":"GET", "requestUri":"/domains/{domainId}/subscriptions", "responseCode":200 }, "input":{"shape":"ListSubscriptionsInput"}, "output":{"shape":"ListSubscriptionsOutput"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"} ], "documentation":"Lists all Subscriptions within a Domain.
", "readonly":true }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"GET", "requestUri":"/tags/{resourceArn}", "responseCode":200 }, "input":{"shape":"ListTagsForResourceInput"}, "output":{"shape":"ListTagsForResourceOutput"}, "documentation":"Lists the tags associated with the specified resource
", "readonly":true }, "StartMedicalScribeListeningSession":{ "name":"StartMedicalScribeListeningSession", "http":{ "method":"POST", "requestUri":"/medical-scribe-stream/", "responseCode":200 }, "input":{"shape":"StartMedicalScribeListeningSessionInput"}, "output":{"shape":"StartMedicalScribeListeningSessionOutput"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"}, {"shape":"ServiceQuotaExceededException"} ], "documentation":"Starts a new Medical Scribe listening session for real-time audio transcription
", "endpoint":{"hostPrefix":"streaming."} }, "StartPatientInsightsJob":{ "name":"StartPatientInsightsJob", "http":{ "method":"POST", "requestUri":"/domain/{domainId}/patient-insights-job", "responseCode":200 }, "input":{"shape":"StartPatientInsightsJobRequest"}, "output":{"shape":"StartPatientInsightsJobResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"}, {"shape":"ConflictException"} ], "documentation":"Starts a new patient insights job.
", "endpoint":{"hostPrefix":"runtime."} }, "TagResource":{ "name":"TagResource", "http":{ "method":"POST", "requestUri":"/tags/{resourceArn}", "responseCode":204 }, "input":{"shape":"TagResourceInput"}, "documentation":"Associates the specified tags with the specified resource
", "idempotent":true }, "UntagResource":{ "name":"UntagResource", "http":{ "method":"DELETE", "requestUri":"/tags/{resourceArn}", "responseCode":204 }, "input":{"shape":"UntagResourceInput"}, "documentation":"Removes the specified tags from the specified resource
", "idempotent":true } }, "shapes":{ "AccessDeniedException":{ "type":"structure", "members":{ "message":{"shape":"String"} }, "documentation":"This error is thrown when the client does not supply proper credentials to the API.
", "error":{ "httpStatusCode":401, "senderFault":true }, "exception":true }, "ActivateSubscriptionInput":{ "type":"structure", "required":[ "domainId", "subscriptionId" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The unique identifier of the parent Domain.
", "location":"uri", "locationName":"domainId" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"The unique identifier of the Subscription.
", "location":"uri", "locationName":"subscriptionId" } } }, "ActivateSubscriptionOutput":{ "type":"structure", "members":{ "subscription":{ "shape":"SubscriptionDescription", "documentation":"" } } }, "ArtifactDetails":{ "type":"structure", "members":{ "outputLocation":{ "shape":"Uri", "documentation":"" }, "status":{ "shape":"PostStreamArtifactGenerationStatus", "documentation":"The generation status of the artifact
" }, "failureReason":{ "shape":"ErrorMessage", "documentation":"The reason for failure if the artifact generation failed
" } }, "documentation":"Details about a generated artifact including location and status
" }, "AudioChunk":{"type":"blob"}, "AudioOffset":{ "type":"double", "box":true }, "ClinicalNoteGenerationResult":{ "type":"structure", "members":{ "noteResult":{ "shape":"ArtifactDetails", "documentation":"Details about the generated clinical note
" }, "transcriptResult":{ "shape":"ArtifactDetails", "documentation":"Details about the generated transcript
" }, "afterVisitSummaryResult":{ "shape":"ArtifactDetails", "documentation":"Details about the generated after visit summary
" } }, "documentation":"Results of clinical note generation including note, transcript, and summary
" }, "ClinicalNoteGenerationSettings":{ "type":"structure", "required":["noteTemplateSettings"], "members":{ "noteTemplateSettings":{ "shape":"NoteTemplateSettings", "documentation":"Settings for the note template to use
" } }, "documentation":"Settings for generating clinical notes from the audio stream
" }, "ClinicalNoteGenerationSettingsResponse":{ "type":"structure", "members":{ "noteTemplateSettings":{ "shape":"NoteTemplateSettingsResponse", "documentation":"Settings for the note template used
" } }, "documentation":"Response containing settings for clinical note generation
" }, "ConflictException":{ "type":"structure", "members":{ "message":{"shape":"String"} }, "documentation":"This error is thrown when a resource update is no longer valid due to assumptions about initial state changing.
", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true }, "CreateDomainInput":{ "type":"structure", "required":["name"], "members":{ "name":{ "shape":"DomainName", "documentation":"The name for the new Domain.
" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"The ARN of the KMS key to use for encrypting data in this Domain.
" }, "webAppSetupConfiguration":{ "shape":"CreateWebAppConfiguration", "documentation":"Configuration for the Domain web application. Optional, but if provided all fields are required.
" }, "tags":{ "shape":"TagMap", "documentation":"Tags to associate with the Domain.
" } } }, "CreateDomainOutput":{ "type":"structure", "required":[ "domainId", "arn", "name", "status", "createdAt" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"" }, "arn":{ "shape":"DomainArn", "documentation":"" }, "name":{ "shape":"DomainName", "documentation":"" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"" }, "encryptionContext":{ "shape":"EncryptionContext", "documentation":"" }, "status":{ "shape":"DomainStatus", "documentation":"" }, "webAppUrl":{ "shape":"WebAppUrl", "documentation":"" }, "webAppConfiguration":{ "shape":"WebAppConfiguration", "documentation":"" }, "createdAt":{ "shape":"Timestamp", "documentation":"" } } }, "CreateSubscriptionInput":{ "type":"structure", "required":["domainId"], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The unique identifier of the parent Domain.
", "location":"uri", "locationName":"domainId" } } }, "CreateSubscriptionOutput":{ "type":"structure", "required":[ "domainId", "subscriptionId", "arn", "status", "createdAt", "lastUpdatedAt" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"" }, "arn":{ "shape":"SubscriptionArn", "documentation":"" }, "status":{ "shape":"SubscriptionStatus", "documentation":"" }, "createdAt":{ "shape":"Timestamp", "documentation":"" }, "lastUpdatedAt":{ "shape":"Timestamp", "documentation":"" }, "activatedAt":{ "shape":"Timestamp", "documentation":"" }, "deactivatedAt":{ "shape":"Timestamp", "documentation":"" } } }, "CreateWebAppConfiguration":{ "type":"structure", "required":[ "ehrRole", "idcInstanceId", "idcRegion" ], "members":{ "ehrRole":{ "shape":"CreateWebAppConfigurationEhrRoleString", "documentation":"ARN of the IAM role used for EHR operations.
" }, "idcInstanceId":{ "shape":"CreateWebAppConfigurationIdcInstanceIdString", "documentation":"The Identity Center instance ID to use for creating the application.
" }, "idcRegion":{ "shape":"CreateWebAppConfigurationIdcRegionString", "documentation":"The AWS region where Identity Center is configured.
" } }, "documentation":"Input configuration for creating a Pulse web application. Used only in CreateDomain operation input.
" }, "CreateWebAppConfigurationEhrRoleString":{ "type":"string", "max":2048, "min":1, "pattern":"arn:aws:iam::[0-9]{12}:role/.+" }, "CreateWebAppConfigurationIdcInstanceIdString":{ "type":"string", "max":256, "min":1 }, "CreateWebAppConfigurationIdcRegionString":{ "type":"string", "max":64, "min":1 }, "CustomTemplate":{ "type":"structure", "required":[ "templateType", "templateInstructions" ], "members":{ "templateType":{ "shape":"CustomTemplateBase", "documentation":"The base template type to customize
" }, "templateInstructions":{ "shape":"TemplateInstructions", "documentation":"Custom instructions for each section of the template
" } }, "documentation":"Configuration for using a custom note template with specific instructions
" }, "CustomTemplateBase":{ "type":"string", "enum":[ "HISTORY_AND_PHYSICAL", "GIRPP", "DAP", "SIRP", "BIRP", "BEHAVIORAL_SOAP" ] }, "CustomTemplateResponse":{ "type":"structure", "members":{ "templateType":{ "shape":"CustomTemplateBase", "documentation":"The base template type that was customized
" } }, "documentation":"Response containing custom template information
" }, "DeactivateSubscriptionInput":{ "type":"structure", "required":[ "domainId", "subscriptionId" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The unique identifier of the parent Domain.
", "location":"uri", "locationName":"domainId" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"The unique identifier of the Subscription.
", "location":"uri", "locationName":"subscriptionId" } } }, "DeactivateSubscriptionOutput":{ "type":"structure", "members":{ "subscription":{ "shape":"SubscriptionDescription", "documentation":"" } } }, "DeleteDomainInput":{ "type":"structure", "required":["domainId"], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The id of the Domain to delete
", "location":"uri", "locationName":"domainId" } } }, "DeleteDomainOutput":{ "type":"structure", "required":[ "domainId", "arn", "status" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The id of the Domain requested for deletion
" }, "arn":{ "shape":"DomainArn", "documentation":"The ARN of the Domain that was requested for deletion
" }, "status":{ "shape":"DomainStatus", "documentation":"Current status of Domain
" } } }, "DomainArn":{ "type":"string", "pattern":"arn:aws:health-agent:[a-z0-9-]+:[0-9]{12}:domain/(hai-|dom-)[a-z0-9]+" }, "DomainId":{ "type":"string", "max":25, "min":20, "pattern":"(hai-|dom-)[a-z0-9]+" }, "DomainName":{ "type":"string", "max":64, "min":1 }, "DomainStatus":{ "type":"string", "enum":[ "ACTIVE", "DELETING", "DELETED" ] }, "DomainSummary":{ "type":"structure", "required":[ "domainId", "arn", "name", "status", "createdAt" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The unique identifier of the Domain.
" }, "arn":{ "shape":"DomainArn", "documentation":"" }, "name":{ "shape":"DomainName", "documentation":"" }, "status":{ "shape":"DomainStatus", "documentation":"" }, "createdAt":{ "shape":"Timestamp", "documentation":"The timestamp when the Domain was created.
" } }, "documentation":"Summary information about a Domain.
" }, "DomainSummaryList":{ "type":"list", "member":{"shape":"DomainSummary"} }, "EncounterContext":{ "type":"structure", "members":{ "unstructuredContext":{ "shape":"SensitiveMarkdownString", "documentation":"Unstructured context information in markdown format
" } }, "documentation":"Context information about the clinical encounter
" }, "EncryptionContext":{ "type":"structure", "required":["encryptionType"], "members":{ "encryptionType":{ "shape":"EncryptionType", "documentation":"The type of encryption key used.
" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"The ARN of the KMS key. Only present when encryptionType is CUSTOMER_MANAGED_KEY.
" } }, "documentation":"Encryption context for a Domain.
" }, "EncryptionType":{ "type":"string", "enum":[ "AWS_OWNED_KEY", "CUSTOMER_MANAGED_KEY" ] }, "ErrorMessage":{ "type":"string", "max":2048, "min":1, "pattern":"[\\s\\S]*" }, "FHIRServer":{ "type":"structure", "required":["fhirEndpoint"], "members":{ "fhirEndpoint":{ "shape":"FHIRServerFhirEndpointString", "documentation":"FHIR server endpoint URL for accessing patient data.
" }, "oauthToken":{ "shape":"SensitiveNonEmptyString", "documentation":"OAuth token for authenticating with the FHIR server.
" } }, "documentation":"FHIR server configuration for input data source
" }, "FHIRServerFhirEndpointString":{ "type":"string", "pattern":"https?://[a-zA-Z0-9\\-._~:/?#\\[\\]@!$&'()*+,;=%]+" }, "GetDomainInput":{ "type":"structure", "required":["domainId"], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The id of the Domain to get
", "location":"uri", "locationName":"domainId" } } }, "GetDomainOutput":{ "type":"structure", "required":[ "domainId", "arn", "name", "status", "createdAt" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"" }, "arn":{ "shape":"DomainArn", "documentation":"" }, "name":{ "shape":"DomainName", "documentation":"" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"" }, "encryptionContext":{ "shape":"EncryptionContext", "documentation":"" }, "status":{ "shape":"DomainStatus", "documentation":"" }, "webAppUrl":{ "shape":"WebAppUrl", "documentation":"" }, "webAppConfiguration":{ "shape":"WebAppConfiguration", "documentation":"" }, "createdAt":{ "shape":"Timestamp", "documentation":"" }, "tags":{ "shape":"TagMap", "documentation":"Tags associated with the Domain
" } } }, "GetMedicalScribeListeningSessionInput":{ "type":"structure", "required":[ "sessionId", "domainId", "subscriptionId" ], "members":{ "sessionId":{ "shape":"SessionId", "documentation":"The Session identifier
", "location":"uri", "locationName":"sessionId" }, "domainId":{ "shape":"DomainId", "documentation":"The Domain identifier
", "location":"uri", "locationName":"domainId" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"The Subscription identifier
", "location":"uri", "locationName":"subscriptionId" } } }, "GetMedicalScribeListeningSessionOutput":{ "type":"structure", "members":{ "medicalScribeListeningSessionDetails":{ "shape":"MedicalScribeListeningSessionDetails", "documentation":"Details about the Medical Scribe listening session
" } } }, "GetPatientInsightsJobRequest":{ "type":"structure", "required":[ "domainId", "jobId" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"", "location":"uri", "locationName":"domainId" }, "jobId":{ "shape":"JobId", "documentation":"", "location":"uri", "locationName":"jobId" } } }, "GetPatientInsightsJobResponse":{ "type":"structure", "required":[ "jobId", "jobArn", "jobStatus", "patientContext", "insightsContext", "encounterContext", "userContext", "inputDataConfig", "outputDataConfig" ], "members":{ "jobId":{ "shape":"JobId", "documentation":"" }, "jobArn":{ "shape":"JobArn", "documentation":"" }, "jobStatus":{ "shape":"JobStatus", "documentation":"" }, "creationTime":{ "shape":"SyntheticTimestamp_date_time", "documentation":"Date and time the patient insights job was submitted.
" }, "updatedTime":{ "shape":"SyntheticTimestamp_date_time", "documentation":"Date and time the patient insights job was last updated.
" }, "insightsOutput":{ "shape":"InsightsOutput", "documentation":"" }, "statusDetails":{ "shape":"NonEmptyString", "documentation":"Contains information about the status of a job.
" }, "patientContext":{ "shape":"PatientInsightsPatientContext", "documentation":"" }, "insightsContext":{ "shape":"InsightsContext", "documentation":"" }, "encounterContext":{ "shape":"PatientInsightsEncounterContext", "documentation":"" }, "userContext":{ "shape":"UserContext", "documentation":"" }, "inputDataConfig":{ "shape":"InputDataConfig", "documentation":"" }, "outputDataConfig":{ "shape":"OutputDataConfig", "documentation":"" } } }, "GetSubscriptionInput":{ "type":"structure", "required":[ "domainId", "subscriptionId" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The unique identifier of the parent Domain.
", "location":"uri", "locationName":"domainId" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"The unique identifier of the Subscription.
", "location":"uri", "locationName":"subscriptionId" } } }, "GetSubscriptionOutput":{ "type":"structure", "members":{ "subscription":{ "shape":"SubscriptionDescription", "documentation":"" } } }, "InputDataConfig":{ "type":"structure", "members":{ "fhirServer":{ "shape":"FHIRServer", "documentation":"FHIR server configuration to retrieve patient data.
" }, "s3Sources":{ "shape":"S3Sources", "documentation":"List of S3 sources containing patient data.
" } }, "documentation":"Configuration details for input patient data
" }, "InsightsContext":{ "type":"structure", "required":["insightsType"], "members":{ "insightsType":{ "shape":"InsightsType", "documentation":"" } }, "documentation":"Details for insights that user wants to generate
" }, "InsightsOutput":{ "type":"structure", "required":["uri"], "members":{ "uri":{ "shape":"S3Uri", "documentation":"" } }, "documentation":"Output of patient insights job
" }, "InsightsType":{ "type":"string", "enum":["PRE_VISIT"] }, "InternalServerException":{ "type":"structure", "members":{ "message":{"shape":"String"} }, "documentation":"This error is thrown when a transient error causes our API to fail.
", "error":{"httpStatusCode":500}, "exception":true, "fault":true, "retryable":{"throttling":false} }, "JobArn":{ "type":"string", "max":200, "min":20, "pattern":"arn:aws[-a-z]*:health-agent:[-a-z0-9]+:[0-9]{12}:domain/[-a-zA-Z0-9-]+/patient-insights-job/[-a-zA-Z0-9_/.]+" }, "JobId":{ "type":"string", "max":36, "min":1 }, "JobStatus":{ "type":"string", "enum":[ "SUBMITTED", "IN_PROGRESS", "FAILED", "SUCCEEDED" ] }, "KmsKeyArn":{ "type":"string", "pattern":"arn:aws:kms:[a-z0-9-]+:[0-9]{12}:key/[a-f0-9-]+" }, "ListDomainsInput":{ "type":"structure", "members":{ "status":{ "shape":"DomainStatus", "documentation":"Filter by Domain status.
", "location":"querystring", "locationName":"status" }, "maxResults":{ "shape":"ListDomainsInputMaxResultsInteger", "documentation":"Maximum number of results to return.
", "location":"querystring", "locationName":"maxResults" }, "nextToken":{ "shape":"String", "documentation":"Token for pagination.
", "location":"querystring", "locationName":"nextToken" } } }, "ListDomainsInputMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListDomainsOutput":{ "type":"structure", "required":["domains"], "members":{ "domains":{ "shape":"DomainSummaryList", "documentation":"List of Domains.
" }, "nextToken":{ "shape":"String", "documentation":"Token for the next page of results.
" } } }, "ListSubscriptionsInput":{ "type":"structure", "required":["domainId"], "members":{ "domainId":{ "shape":"DomainId", "documentation":"The unique identifier of the parent Domain.
", "location":"uri", "locationName":"domainId" }, "maxResults":{ "shape":"ListSubscriptionsInputMaxResultsInteger", "documentation":"Maximum number of results to return.
", "location":"querystring", "locationName":"maxResults" }, "nextToken":{ "shape":"String", "documentation":"Token for pagination.
", "location":"querystring", "locationName":"nextToken" } } }, "ListSubscriptionsInputMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListSubscriptionsOutput":{ "type":"structure", "required":["subscriptions"], "members":{ "subscriptions":{ "shape":"SubscriptionList", "documentation":"List of Subscriptions.
" }, "nextToken":{ "shape":"String", "documentation":"Token for the next page of results.
" } } }, "ListTagsForResourceInput":{ "type":"structure", "required":["resourceArn"], "members":{ "resourceArn":{ "shape":"String", "documentation":"The ARN of the resource to list tags for
", "location":"uri", "locationName":"resourceArn" } } }, "ListTagsForResourceOutput":{ "type":"structure", "members":{ "tags":{ "shape":"TagMap", "documentation":"The tags associated with the resource
" } } }, "ManagedNoteTemplate":{ "type":"string", "enum":[ "HISTORY_AND_PHYSICAL", "GIRPP", "DAP", "SIRP", "BIRP", "BEHAVIORAL_SOAP", "PHYSICAL_SOAP" ] }, "ManagedTemplate":{ "type":"structure", "required":["templateType"], "members":{ "templateType":{ "shape":"ManagedNoteTemplate", "documentation":"The type of managed template to use
" } }, "documentation":"Configuration for using a managed note template
" }, "ManagedTemplateResponse":{ "type":"structure", "members":{ "templateType":{ "shape":"ManagedNoteTemplate", "documentation":"The type of managed template used
" } }, "documentation":"Response containing managed template information
" }, "MedicalScribeAudioEvent":{ "type":"structure", "required":["audioChunk"], "members":{ "audioChunk":{ "shape":"AudioChunk", "documentation":"The audio data chunk
" } }, "documentation":"An event containing audio data for the Medical Scribe stream
", "event":true }, "MedicalScribeChannelDefinition":{ "type":"structure", "required":[ "channelId", "participantRole" ], "members":{ "channelId":{ "shape":"MedicalScribeChannelId", "documentation":"The channel identifier
" }, "participantRole":{ "shape":"MedicalScribeParticipantRole", "documentation":"The role of the participant on this channel
" } }, "documentation":"Defines a channel in the audio stream
" }, "MedicalScribeChannelDefinitions":{ "type":"list", "member":{"shape":"MedicalScribeChannelDefinition"}, "max":2, "min":2 }, "MedicalScribeChannelId":{ "type":"integer", "box":true, "max":1, "min":0 }, "MedicalScribeConfigurationEvent":{ "type":"structure", "required":["postStreamActionSettings"], "members":{ "postStreamActionSettings":{ "shape":"MedicalScribePostStreamActionSettings", "documentation":"Settings for actions to perform after the stream ends
" }, "channelDefinitions":{ "shape":"MedicalScribeChannelDefinitions", "documentation":"Channel definitions for the audio stream
" }, "encounterContext":{ "shape":"EncounterContext", "documentation":"Context information about the clinical encounter
" } }, "documentation":"An event containing configuration for the Medical Scribe session
", "event":true }, "MedicalScribeInputStream":{ "type":"structure", "members":{ "audioEvent":{ "shape":"MedicalScribeAudioEvent", "documentation":"" }, "sessionControlEvent":{ "shape":"MedicalScribeSessionControlEvent", "documentation":"" }, "configurationEvent":{ "shape":"MedicalScribeConfigurationEvent", "documentation":"" } }, "documentation":"Input stream for Medical Scribe containing audio and configuration events
", "eventstream":true }, "MedicalScribeLanguageCode":{ "type":"string", "enum":["en-US"] }, "MedicalScribeListeningSessionDetails":{ "type":"structure", "members":{ "sessionId":{ "shape":"SessionId", "documentation":"The Session identifier
" }, "domainId":{ "shape":"DomainId", "documentation":"The Domain identifier
" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"The Subscription identifier
" }, "languageCode":{ "shape":"MedicalScribeLanguageCode", "documentation":"The Language Code for the audio in the session
" }, "mediaSampleRateHertz":{ "shape":"MedicalScribeMediaSampleRateHertz", "documentation":"The sample rate of the input audio
" }, "mediaEncoding":{ "shape":"MedicalScribeMediaEncoding", "documentation":"The encoding for the input audio
" }, "channelDefinitions":{ "shape":"MedicalScribeChannelDefinitions", "documentation":"Channel definitions for the audio stream
" }, "postStreamActionSettings":{ "shape":"MedicalScribePostStreamActionSettingsResponse", "documentation":"Settings for post-stream actions
" }, "postStreamActionResult":{ "shape":"MedicalScribePostStreamActionsResult", "documentation":"Results of post-stream actions
" }, "encounterContextProvided":{ "shape":"NonNullBoolean", "documentation":"Indicates whether encounter context was provided
" }, "streamStatus":{ "shape":"MedicalScribeStreamStatus", "documentation":"The current status of the stream
" }, "streamCreationTime":{ "shape":"Timestamp", "documentation":"The timestamp when the stream was created
" }, "streamEndTime":{ "shape":"Timestamp", "documentation":"The timestamp when the stream ended
" } }, "documentation":"Detailed information about a Medical Scribe listening session
" }, "MedicalScribeMediaEncoding":{ "type":"string", "enum":[ "pcm", "flac" ] }, "MedicalScribeMediaSampleRateHertz":{ "type":"integer", "box":true, "max":48000, "min":8000 }, "MedicalScribeOutputStream":{ "type":"structure", "members":{ "transcriptEvent":{ "shape":"MedicalScribeTranscriptEvent", "documentation":"" }, "internalFailureException":{ "shape":"InternalServerException", "documentation":"" }, "validationException":{ "shape":"ValidationException", "documentation":"" } }, "documentation":"Output stream from Medical Scribe containing transcript events and errors
", "eventstream":true }, "MedicalScribeParticipantRole":{ "type":"string", "enum":[ "PATIENT", "CLINICIAN" ] }, "MedicalScribePostStreamActionSettings":{ "type":"structure", "required":[ "outputS3Uri", "clinicalNoteGenerationSettings" ], "members":{ "outputS3Uri":{ "shape":"S3Uri", "documentation":"" }, "clinicalNoteGenerationSettings":{ "shape":"ClinicalNoteGenerationSettings", "documentation":"Settings for clinical note generation
" } }, "documentation":"Settings for actions to perform after the audio stream ends
" }, "MedicalScribePostStreamActionSettingsResponse":{ "type":"structure", "required":[ "outputS3Uri", "clinicalNoteGenerationSettings" ], "members":{ "outputS3Uri":{ "shape":"S3Uri", "documentation":"" }, "clinicalNoteGenerationSettings":{ "shape":"ClinicalNoteGenerationSettingsResponse", "documentation":"Settings for clinical note generation
" } }, "documentation":"Response containing settings for post-stream actions
" }, "MedicalScribePostStreamActionsResult":{ "type":"structure", "members":{ "clinicalNoteGenerationResult":{ "shape":"ClinicalNoteGenerationResult", "documentation":"Results of clinical note generation
" } }, "documentation":"Results of post-stream actions performed after the audio stream ended
" }, "MedicalScribeSessionControlEvent":{ "type":"structure", "members":{ "type":{ "shape":"MedicalScribeSessionControlEventType", "documentation":"The type of session control event
" } }, "documentation":"An event for controlling the Medical Scribe session
", "event":true }, "MedicalScribeSessionControlEventType":{ "type":"string", "enum":["END_OF_SESSION"] }, "MedicalScribeStreamStatus":{ "type":"string", "enum":[ "IN_PROGRESS", "PAUSED", "FAILED", "COMPLETED" ] }, "MedicalScribeTranscriptEvent":{ "type":"structure", "members":{ "transcriptSegment":{ "shape":"MedicalScribeTranscriptSegment", "documentation":"A segment of the transcript
" } }, "documentation":"An event containing transcript data from the Medical Scribe stream
", "event":true }, "MedicalScribeTranscriptSegment":{ "type":"structure", "members":{ "segmentId":{ "shape":"String", "documentation":"The unique identifier for this segment
" }, "audioBeginOffset":{ "shape":"AudioOffset", "documentation":"The offset from audio start when the audio for this segment begins
" }, "audioEndOffset":{ "shape":"AudioOffset", "documentation":"The offset from audio start when the audio for this segment ends
" }, "isPartial":{ "shape":"NonNullBoolean", "documentation":"Indicates whether this is a partial or final transcript
" }, "channelId":{ "shape":"String", "documentation":"The channel identifier for this segment
" }, "content":{ "shape":"String", "documentation":"The transcript text content
" } }, "documentation":"A segment of transcript text with timing and channel information
" }, "NonEmptyString":{ "type":"string", "pattern":".*[\\s\\S]*\\S[\\s\\S]*.*" }, "NonNullBoolean":{ "type":"boolean", "box":true }, "NoteTemplateSettings":{ "type":"structure", "members":{ "managedTemplate":{ "shape":"ManagedTemplate", "documentation":"" }, "customTemplate":{ "shape":"CustomTemplate", "documentation":"" } }, "documentation":"Settings for the note template to use for clinical note generation
", "union":true }, "NoteTemplateSettingsResponse":{ "type":"structure", "members":{ "managedTemplate":{ "shape":"ManagedTemplateResponse", "documentation":"" }, "customTemplate":{ "shape":"CustomTemplateResponse", "documentation":"" } }, "documentation":"Response containing note template settings
", "union":true }, "OutputDataConfig":{ "type":"structure", "required":["s3OutputPath"], "members":{ "s3OutputPath":{ "shape":"S3Uri", "documentation":"S3 URI where the insights output will be stored.
" } }, "documentation":"Configuration details for insights output.
" }, "PatientInsightsEncounterContext":{ "type":"structure", "required":["encounterReason"], "members":{ "encounterReason":{ "shape":"PatientInsightsEncounterContextEncounterReasonString", "documentation":"Chief complaint for the visit
" } }, "documentation":"Details for an encounter
" }, "PatientInsightsEncounterContextEncounterReasonString":{ "type":"string", "max":256, "min":1, "pattern":"[a-zA-Z0-9 .,-]+", "sensitive":true }, "PatientInsightsPatientContext":{ "type":"structure", "required":["patientId"], "members":{ "patientId":{ "shape":"SensitiveNonEmptyString", "documentation":"Unique identifier of the patient
" }, "dateOfBirth":{ "shape":"SensitiveIsoDateString", "documentation":"Date of birth of the patient.
" }, "pronouns":{ "shape":"Pronouns", "documentation":"Pronouns preferred by the patient.
" } }, "documentation":"Details for a patient
" }, "PostStreamArtifactGenerationStatus":{ "type":"string", "enum":[ "IN_PROGRESS", "FAILED", "COMPLETED" ] }, "Pronouns":{ "type":"string", "enum":[ "HE_HIM", "SHE_HER", "THEY_THEM" ], "sensitive":true }, "ProviderRole":{ "type":"string", "enum":["CLINICIAN"] }, "RequestId":{ "type":"string", "max":256, "min":1 }, "ResourceNotFoundException":{ "type":"structure", "members":{ "message":{"shape":"String"} }, "documentation":"This error is thrown when the requested resource is not found.
", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "S3Source":{ "type":"structure", "required":["uri"], "members":{ "uri":{ "shape":"S3Uri", "documentation":"The S3 URI.
" } }, "documentation":"S3 uri for input data source
" }, "S3Sources":{ "type":"list", "member":{"shape":"S3Source"}, "max":10, "min":0 }, "S3Uri":{ "type":"string", "max":1024, "min":0, "pattern":"s3://[a-z0-9][\\.\\-a-z0-9]{1,61}[a-z0-9](/.*)?" }, "SensitiveAlphanumericString":{ "type":"string", "pattern":"[a-zA-Z0-9]+", "sensitive":true }, "SensitiveIsoDateString":{ "type":"string", "pattern":"\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])", "sensitive":true }, "SensitiveMarkdownString":{ "type":"string", "pattern":"[a-zA-Z0-9\\s\\*_\\-#\\[\\]\\(\\)\\.,:;!?'\"`<>~]+", "sensitive":true }, "SensitiveNonEmptyString":{ "type":"string", "pattern":".*[\\s\\S]*\\S[\\s\\S]*.*", "sensitive":true }, "ServiceQuotaExceededException":{ "type":"structure", "members":{ "message":{"shape":"String"} }, "documentation":"The request exceeds a service quota.
", "error":{ "httpStatusCode":402, "senderFault":true }, "exception":true }, "SessionId":{ "type":"string", "max":36, "min":36, "pattern":".*[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}.*" }, "Specialty":{ "type":"string", "enum":["PRIMARY_CARE"] }, "StartMedicalScribeListeningSessionInput":{ "type":"structure", "required":[ "sessionId", "domainId", "subscriptionId", "languageCode", "mediaSampleRateHertz", "mediaEncoding" ], "members":{ "sessionId":{ "shape":"SessionId", "documentation":"The Session identifier
", "location":"header", "locationName":"x-amzn-medscribe-session-id" }, "domainId":{ "shape":"DomainId", "documentation":"The Domain identifier
", "location":"header", "locationName":"x-amzn-medscribe-domain-id" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"The Subscription identifier
", "location":"header", "locationName":"x-amzn-medscribe-subscription-id" }, "languageCode":{ "shape":"MedicalScribeLanguageCode", "documentation":"The Language Code for the audio in the session
", "location":"header", "locationName":"x-amzn-medscribe-language-code" }, "mediaSampleRateHertz":{ "shape":"MedicalScribeMediaSampleRateHertz", "documentation":"The sample rate of the input audio
", "location":"header", "locationName":"x-amzn-medscribe-sample-rate" }, "mediaEncoding":{ "shape":"MedicalScribeMediaEncoding", "documentation":"The encoding for the input audio
", "location":"header", "locationName":"x-amzn-medscribe-media-encoding" }, "inputStream":{ "shape":"MedicalScribeInputStream", "documentation":"" } }, "payload":"inputStream" }, "StartMedicalScribeListeningSessionOutput":{ "type":"structure", "members":{ "sessionId":{ "shape":"SessionId", "documentation":"The Session identifier
", "location":"header", "locationName":"x-amzn-medscribe-session-id" }, "domainId":{ "shape":"DomainId", "documentation":"The Domain identifier
", "location":"header", "locationName":"x-amzn-medscribe-domain-id" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"The Subscription identifier
", "location":"header", "locationName":"x-amzn-medscribe-subscription-id" }, "requestId":{ "shape":"RequestId", "documentation":"The Request identifier
", "location":"header", "locationName":"x-amzn-request-id" }, "languageCode":{ "shape":"MedicalScribeLanguageCode", "documentation":"The Language Code for the audio in the session
", "location":"header", "locationName":"x-amzn-medscribe-language-code" }, "mediaSampleRateHertz":{ "shape":"MedicalScribeMediaSampleRateHertz", "documentation":"The sample rate of the input audio
", "location":"header", "locationName":"x-amzn-medscribe-sample-rate" }, "mediaEncoding":{ "shape":"MedicalScribeMediaEncoding", "documentation":"The encoding for the input audio
", "location":"header", "locationName":"x-amzn-medscribe-media-encoding" }, "responseStream":{ "shape":"MedicalScribeOutputStream", "documentation":"The output stream containing transcript events
" } }, "payload":"responseStream" }, "StartPatientInsightsJobRequest":{ "type":"structure", "required":[ "domainId", "patientContext", "insightsContext", "encounterContext", "userContext", "inputDataConfig", "outputDataConfig" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"", "location":"uri", "locationName":"domainId" }, "patientContext":{ "shape":"PatientInsightsPatientContext", "documentation":"" }, "insightsContext":{ "shape":"InsightsContext", "documentation":"" }, "encounterContext":{ "shape":"PatientInsightsEncounterContext", "documentation":"" }, "userContext":{ "shape":"UserContext", "documentation":"" }, "inputDataConfig":{ "shape":"InputDataConfig", "documentation":"" }, "outputDataConfig":{ "shape":"OutputDataConfig", "documentation":"" }, "clientToken":{ "shape":"NonEmptyString", "documentation":"Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
", "idempotencyToken":true } } }, "StartPatientInsightsJobResponse":{ "type":"structure", "required":[ "jobArn", "jobId" ], "members":{ "jobArn":{ "shape":"JobArn", "documentation":"" }, "jobId":{ "shape":"JobId", "documentation":"" }, "creationTime":{ "shape":"SyntheticTimestamp_date_time", "documentation":"Date and time the patient insights job was submitted.
" } } }, "String":{"type":"string"}, "SubscriptionArn":{ "type":"string", "pattern":"arn:aws:health-agent:[a-z0-9-]+:[0-9]{12}:domain/(hai-|dom-)[a-z0-9]+/subscription/sub-[a-zA-Z0-9]{21}" }, "SubscriptionDescription":{ "type":"structure", "required":[ "domainId", "subscriptionId", "arn", "status", "createdAt", "lastUpdatedAt" ], "members":{ "domainId":{ "shape":"DomainId", "documentation":"" }, "subscriptionId":{ "shape":"SubscriptionId", "documentation":"" }, "arn":{ "shape":"SubscriptionArn", "documentation":"" }, "status":{ "shape":"SubscriptionStatus", "documentation":"" }, "createdAt":{ "shape":"Timestamp", "documentation":"" }, "lastUpdatedAt":{ "shape":"Timestamp", "documentation":"" }, "activatedAt":{ "shape":"Timestamp", "documentation":"" }, "deactivatedAt":{ "shape":"Timestamp", "documentation":"" } }, "documentation":"Complete subscription resource data.
" }, "SubscriptionId":{ "type":"string", "max":25, "min":25, "pattern":"sub-[a-zA-Z0-9]{21}" }, "SubscriptionList":{ "type":"list", "member":{"shape":"SubscriptionDescription"} }, "SubscriptionStatus":{ "type":"string", "enum":[ "ACTIVE", "INACTIVE", "DELETED" ] }, "SyntheticTimestamp_date_time":{ "type":"timestamp", "timestampFormat":"iso8601" }, "TagKey":{ "type":"string", "max":128, "min":1 }, "TagKeyList":{ "type":"list", "member":{"shape":"TagKey"}, "max":50, "min":1 }, "TagMap":{ "type":"map", "key":{"shape":"TagKey"}, "value":{"shape":"TagValue"} }, "TagResourceInput":{ "type":"structure", "required":[ "resourceArn", "tags" ], "members":{ "resourceArn":{ "shape":"String", "documentation":"The ARN of the resource to tag
", "location":"uri", "locationName":"resourceArn" }, "tags":{ "shape":"TagMap", "documentation":"The tags to add to the resource
" } } }, "TagValue":{ "type":"string", "max":256, "min":0 }, "TemplateInstructions":{ "type":"list", "member":{"shape":"TemplateSectionInstruction"}, "max":20, "min":1 }, "TemplateSectionInstruction":{ "type":"structure", "required":[ "sectionHeader", "sectionInstruction" ], "members":{ "sectionHeader":{ "shape":"SensitiveAlphanumericString", "documentation":"The header for this section of the template
" }, "sectionInstruction":{ "shape":"SensitiveMarkdownString", "documentation":"The instruction for generating this section
" } }, "documentation":"Instructions for generating a specific section of a clinical note
" }, "ThrottlingException":{ "type":"structure", "members":{ "message":{"shape":"String"} }, "documentation":"This error is thrown when the client exceeds the allowed request rate.
", "error":{ "httpStatusCode":429, "senderFault":true }, "exception":true, "retryable":{"throttling":true} }, "Timestamp":{"type":"timestamp"}, "UntagResourceInput":{ "type":"structure", "required":[ "resourceArn", "tagKeys" ], "members":{ "resourceArn":{ "shape":"String", "documentation":"The ARN of the resource to untag
", "location":"uri", "locationName":"resourceArn" }, "tagKeys":{ "shape":"TagKeyList", "documentation":"The tag keys to remove from the resource
", "location":"querystring", "locationName":"tagKeys" } } }, "Uri":{ "type":"string", "min":1, "pattern":".*(s3://|http(s*)://).+.*" }, "UserContext":{ "type":"structure", "required":[ "role", "userId" ], "members":{ "role":{ "shape":"ProviderRole", "documentation":"" }, "userId":{ "shape":"SensitiveNonEmptyString", "documentation":"Unique identifier of the user
" }, "specialty":{ "shape":"Specialty", "documentation":"" } }, "documentation":"Details for user initiating insights job
" }, "ValidationException":{ "type":"structure", "members":{ "message":{"shape":"String"} }, "documentation":"This error is thrown when the client supplies invalid input to the API.
", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "WebAppConfiguration":{ "type":"structure", "required":[ "ehrRole", "idcApplicationId", "idcRegion" ], "members":{ "ehrRole":{ "shape":"WebAppConfigurationEhrRoleString", "documentation":"ARN of the IAM role used for EHR operations.
" }, "idcApplicationId":{ "shape":"WebAppConfigurationIdcApplicationIdString", "documentation":"The Identity Center application ID associated with this Domain.
" }, "idcRegion":{ "shape":"WebAppConfigurationIdcRegionString", "documentation":"The AWS region where Identity Center is configured.
" } }, "documentation":"Configuration for the Domain web application, including Identity Center settings. If provided, all fields are required.
" }, "WebAppConfigurationEhrRoleString":{ "type":"string", "max":2048, "min":1, "pattern":"arn:aws:iam::[0-9]{12}:role/.+" }, "WebAppConfigurationIdcApplicationIdString":{ "type":"string", "max":256, "min":1 }, "WebAppConfigurationIdcRegionString":{ "type":"string", "max":64, "min":1 }, "WebAppUrl":{"type":"string"} }, "documentation":"Health Agent for healthcare providers and patient engagement
" }