{ "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

" }