Auto Scribe

ModelsExpand Collapse

enum ClinicalReferenceType:

Category of canonical clinical reference value used for study workflow pickers and normalization.

enum HeightUnit:

Unit of measure for a height value. ‘in’ = inches, ‘cm’ = centimeters.

enum ReportStatus:

Status of an individual report. ‘in_progress’ = actively being dictated, ‘completed’ = signed.

enum Sex:

Patient’s biological sex. Options: ‘male’, ‘female’, ‘other’

class StudyReportMetadata:

Patient demographics and scan information for report generation

string Age

Patient’s age at study date (e.g., ‘34.5 years’, ‘2 months’)

string DateOfBirth

Patient’s date of birth. Format: YYYY-MM-DD (e.g., ‘1990-05-20’)

string FacilityName

Name of the medical facility where the scan was performed

Height Height

Patient’s height with unit (e.g., {value: 70, unit: ‘inches’} or {value: 178, unit: ‘cm’})

required HeightUnit Unit

Unit of measure for a height value. ‘in’ = inches, ‘cm’ = centimeters.

One of the following:

required Double Value

minimum0

string Mrn

Medical Record Number - unique patient identifier

string PatientName

Full name of the patient

string Procedure

Procedure or study type (e.g., ‘MRI Brain with Contrast’). Maps to database scan_type and dictation report_header.scan_type.

string ReferringPhysicianName

Name of the physician who referred the patient for this scan

Sex Sex

Patient’s biological sex. Options: ‘male’, ‘female’, ‘other’

One of the following:

string StudyDate

Study date (YYYY-MM-DD). Maps to database scan_date and dictation report_header.scan_date.

string StudyTime

Study time (HH:MM). Maps to database scan_time and dictation report_header.scan_time.

Weight Weight

Patient’s weight with unit (e.g., {value: 150, unit: ‘lbs’} or {value: 68, unit: ‘kg’})

required WeightUnit Unit

Unit of measure for a weight value. ‘lbs’ = pounds, ‘kg’ = kilograms.

One of the following:

required Double Value

minimum0

enum StudyReportStatus:

AutoScribe report workflow status for a study. ‘unassigned’ = no radiologist assigned, ‘assigned’ = assigned but not started, ‘in_progress’ = actively being dictated, ‘completed’ = report signed, ‘addendum_active’ = addendum in progress.

enum StudyType:

Kind of study. ‘standard’ is a live AutoScribe reading-workflow study. ‘external’ is an imported archive study.

enum WeightUnit:

Unit of measure for a weight value. ‘lbs’ = pounds, ‘kg’ = kilograms.

Auto ScribeClinical References

Create a clinical reference

ClinicalReference AutoScribe.ClinicalReferences.Create(, )

POST/v1/autoScribe/clinicalReferences

List clinical references

ClinicalReferenceListPageResponse AutoScribe.ClinicalReferences.List(, )

GET/v1/autoScribe/clinicalReferences

Retrieve a clinical reference by ID

ClinicalReference AutoScribe.ClinicalReferences.Retrieve(, )

GET/v1/autoScribe/clinicalReferences/{clinicalReferenceId}

Retrieve a clinical reference by external reference ID

ClinicalReference AutoScribe.ClinicalReferences.RetrieveByExternalReferenceID(, )

GET/v1/autoScribe/clinicalReferences/byExternalReferenceId/{externalReferenceId}

Update a clinical reference

ClinicalReference AutoScribe.ClinicalReferences.Update(, )

PATCH/v1/autoScribe/clinicalReferences/{clinicalReferenceId}

Delete a clinical reference

ClinicalReference AutoScribe.ClinicalReferences.Delete(, )

POST/v1/autoScribe/clinicalReferences/{clinicalReferenceId}/delete

ModelsExpand Collapse

class ClinicalReference:

A canonical clinical reference value for study workflow pickers and normalization

required string ClinicalReferenceID

Unique clinical reference identifier. Format: ref_{32-hex-chars}

required DateTimeOffset? CreatedAt

Timestamp when the clinical reference was created

formatdate-time

required Boolean IsActive

Whether this reference is active and available for pickers

required string Name

Canonical display name for this reference value

minLength1

required ClinicalReferenceType Type

Category of canonical clinical reference value used for study workflow pickers and normalization.

One of the following:

required DateTimeOffset? UpdatedAt

Timestamp when the clinical reference was last updated

formatdate-time

ExpressCustomerReference? ExpressCustomer

A reference to an Express customer with basic identifying information

required string ExpressCustomerID

Unique Express customer identifier. Format: cus_{32-hex-chars}

required string ExpressCustomerName

Name of the Express customer

minLength1

string? ExternalReferenceID

Integrator-provided stable identifier for mapping inbound data

IReadOnlyDictionary<string, string> Metadata

Optional key-value metadata. Maximum 50 pairs

Auto ScribeEphemeral Sessions

Create an ephemeral AutoScribe viewer session

EphemeralSessionCreateResponse AutoScribe.EphemeralSessions.Create(, )

POST/v1/autoScribe/ephemeral-sessions

Auto ScribeStudies

Create a new study

StudyCreateResponse AutoScribe.Studies.Create(, )

POST/v1/autoScribe/studies

List studies with pagination

StudyListPageResponse AutoScribe.Studies.List(, )

GET/v1/autoScribe/studies

Retrieve a study by ID

StudyRetrieveResponse AutoScribe.Studies.Retrieve(, )

GET/v1/autoScribe/studies/{studyId}

Update a study

StudyUpdateResponse AutoScribe.Studies.Update(, )

PATCH/v1/autoScribe/studies/{studyId}

Cancel a study

StudyCancelResponse AutoScribe.Studies.Cancel(, )

POST/v1/autoScribe/studies/cancel

Uncancel a study

StudyUncancelResponse AutoScribe.Studies.Uncancel(, )

POST/v1/autoScribe/studies/uncancel

Generate a reroute URL with viewer and dictation

StudyRerouteUrlResponse AutoScribe.Studies.RerouteUrl(, )

POST/v1/autoScribe/studies/reroute-url

Generate a viewer-only reroute URL

StudyViewerOnlyRerouteUrlResponse AutoScribe.Studies.ViewerOnlyRerouteUrl(, )

POST/v1/autoScribe/studies/viewer-only-reroute-url

Retrieve a study by DICOM UID

StudyRetrieveByUidResponse AutoScribe.Studies.RetrieveByUid(, )

GET/v1/autoScribe/studies/by-uid/{studyInstanceUid}

ModelsExpand Collapse

class PriorReport:

External prior report metadata and text stored on a study

required string ReportText

Full prior report text

minLength1

maxLength50000

string ExternalStudyID

Integrator’s external study identifier

minLength1

maxLength256

string Modality

Imaging modality for the prior study

minLength1

maxLength100

string StudyDate

Prior study date (YYYY-MM-DD)

string StudyDescription

Description of the prior study

minLength1

maxLength1000

class ReportIDWithStatus:

A report ID paired with its current status

required Boolean? IsCritical

Whether the report was marked critical at sign-off. null when the report is not yet completed; true/false once completed.

required string ReportID

Unique report identifier. Format: rep_{32-hex-chars}

required ReportStatus Status

Status of an individual report. ‘in_progress’ = actively being dictated, ‘completed’ = signed.

One of the following:

Auto ScribeStudiesExternal

Create an external study

ExternalCreateResponse AutoScribe.Studies.External.Create(, )

POST/v1/autoScribe/studies/external

Delete an external study

ExternalDeleteResponse AutoScribe.Studies.External.Delete(, )

POST/v1/autoScribe/studies/external/delete

Auto ScribeStudiesExternalReports

Attach an external report

ReportCreateResponse AutoScribe.Studies.External.Reports.Create(, )

POST/v1/autoScribe/studies/external/reports

List external reports

ReportListPageResponse AutoScribe.Studies.External.Reports.List(, )

GET/v1/autoScribe/studies/external/reports

Retrieve an external report

ReportRetrieveResponse AutoScribe.Studies.External.Reports.Retrieve(, )

GET/v1/autoScribe/studies/external/reports/{externalReportId}

Auto ScribeUsers

Create and invite a new user

UserInviteResponse AutoScribe.Users.Invite(, )

POST/v1/autoScribe/users

List users with pagination

UserListPageResponse AutoScribe.Users.List(, )

GET/v1/autoScribe/users

Retrieve a user by ID

UserRetrieveResponse AutoScribe.Users.Retrieve(, )

GET/v1/autoScribe/users/{userId}

Update a user

UserUpdateResponse AutoScribe.Users.Update(, )

PATCH/v1/autoScribe/users/{userId}

Revoke user access

UserRevokeAccessResponse AutoScribe.Users.RevokeAccess(, )

POST/v1/autoScribe/users/revoke-access

Reactivate a user

UserReactivateResponse AutoScribe.Users.Reactivate(, )

POST/v1/autoScribe/users/reactivate

Auto ScribeUsersInvitations

List user invitations

InvitationListPageResponse AutoScribe.Users.Invitations.List(, )

GET/v1/autoScribe/users/invitations

Retrieve an invitation by ID

InvitationRetrieveResponse AutoScribe.Users.Invitations.Retrieve(, )

GET/v1/autoScribe/users/invitations/{invitationId}

Update an invitation

InvitationUpdateResponse AutoScribe.Users.Invitations.Update(, )

PATCH/v1/autoScribe/users/invitations/{invitationId}

Revoke an invitation

InvitationRevokeResponse AutoScribe.Users.Invitations.Revoke(, )

POST/v1/autoScribe/users/invitations/revoke

Auto ScribeReports

List reports for a study

ReportListResponse AutoScribe.Reports.List(, )

GET/v1/autoScribe/reports

Retrieve report text

ReportTextResponse AutoScribe.Reports.Text(, )

GET/v1/autoScribe/reports/text

Retrieve report PDF URL

ReportPdfResponse AutoScribe.Reports.Pdf(, )

GET/v1/autoScribe/reports/pdf

Create a report addendum

ReportAddendumResponse AutoScribe.Reports.Addendum(, )

POST/v1/autoScribe/reports/{reportId}/addendum

Cancel a report addendum

ReportCancelAddendumResponse AutoScribe.Reports.CancelAddendum(, )

POST/v1/autoScribe/reports/{reportId}/cancel-addendum

ModelsExpand Collapse

class Report:

A radiology report in the AutoScribe system

required DateTimeOffset? CreatedAt

Timestamp when the report was created

formatdate-time

required Boolean IsAddendum

Whether this report is an addendum to a previous report

required Boolean? IsCritical

Whether the report was marked critical at sign-off. null when the report is not yet completed; true/false once completed.

required string ReportID

Unique report identifier. Format: rep_{32-hex-chars}

required DateTimeOffset? SignedAt

Timestamp when the report was signed, null if not yet signed

formatdate-time

required StudyReportMetadata SnapshotMetadata

Patient demographics and scan information for report generation

string Age

Patient’s age at study date (e.g., ‘34.5 years’, ‘2 months’)

string DateOfBirth

Patient’s date of birth. Format: YYYY-MM-DD (e.g., ‘1990-05-20’)

string FacilityName

Name of the medical facility where the scan was performed

Height Height

Patient’s height with unit (e.g., {value: 70, unit: ‘inches’} or {value: 178, unit: ‘cm’})

required HeightUnit Unit

Unit of measure for a height value. ‘in’ = inches, ‘cm’ = centimeters.

One of the following:

required Double Value

minimum0

string Mrn

Medical Record Number - unique patient identifier

string PatientName

Full name of the patient

string Procedure

Procedure or study type (e.g., ‘MRI Brain with Contrast’). Maps to database scan_type and dictation report_header.scan_type.

string ReferringPhysicianName

Name of the physician who referred the patient for this scan

Sex Sex

Patient’s biological sex. Options: ‘male’, ‘female’, ‘other’

One of the following:

string StudyDate

Study date (YYYY-MM-DD). Maps to database scan_date and dictation report_header.scan_date.

string StudyTime

Study time (HH:MM). Maps to database scan_time and dictation report_header.scan_time.

Weight Weight

Patient’s weight with unit (e.g., {value: 150, unit: ‘lbs’} or {value: 68, unit: ‘kg’})

required WeightUnit Unit

Unit of measure for a weight value. ‘lbs’ = pounds, ‘kg’ = kilograms.

One of the following:

required Double Value

minimum0

required ReportStatus Status

Status of an individual report. ‘in_progress’ = actively being dictated, ‘completed’ = signed.

One of the following:

required string StudyID

Study ID this report belongs to. Format: stu_{32-hex-chars}

required DateTimeOffset? UpdatedAt

Timestamp when the report was last updated

formatdate-time

required string UserID

User ID of the radiologist who created/signed this report. Format: usr_{32-hex-chars}

string ReportPlainText

Plain text content of the report

class ReportPdfItem:

A report with its PDF download URL

required Boolean? IsCritical

Whether the report was marked critical at sign-off. null when the report is not yet completed; true/false once completed.

required string PresignedUrl

Time-limited presigned URL to download the PDF (expires after 1 hour)

required string ReportID

Unique report identifier. Format: rep_{32-hex-chars}

required StudyReportMetadata SnapshotMetadata

Patient demographics and scan information for report generation

string Age

Patient’s age at study date (e.g., ‘34.5 years’, ‘2 months’)

string DateOfBirth

Patient’s date of birth. Format: YYYY-MM-DD (e.g., ‘1990-05-20’)

string FacilityName

Name of the medical facility where the scan was performed

Height Height

Patient’s height with unit (e.g., {value: 70, unit: ‘inches’} or {value: 178, unit: ‘cm’})

required HeightUnit Unit

Unit of measure for a height value. ‘in’ = inches, ‘cm’ = centimeters.

One of the following:

required Double Value

minimum0

string Mrn

Medical Record Number - unique patient identifier

string PatientName

Full name of the patient

string Procedure

Procedure or study type (e.g., ‘MRI Brain with Contrast’). Maps to database scan_type and dictation report_header.scan_type.

string ReferringPhysicianName

Name of the physician who referred the patient for this scan

Sex Sex

Patient’s biological sex. Options: ‘male’, ‘female’, ‘other’

One of the following:

string StudyDate

Study date (YYYY-MM-DD). Maps to database scan_date and dictation report_header.scan_date.

string StudyTime

Study time (HH:MM). Maps to database scan_time and dictation report_header.scan_time.

Weight Weight

Patient’s weight with unit (e.g., {value: 150, unit: ‘lbs’} or {value: 68, unit: ‘kg’})

required WeightUnit Unit

Unit of measure for a weight value. ‘lbs’ = pounds, ‘kg’ = kilograms.

One of the following:

required Double Value

minimum0

required string StudyID

Study ID this report belongs to. Format: stu_{32-hex-chars}

required string StudyInstanceUid

DICOM Study Instance UID. Must be a valid DICOM UID format (e.g., ‘1.2.840.10008.5.1.4.1.1.2’)

minLength1

class ReportTextItem:

A report with its plain text content

required Boolean? IsCritical

Whether the report was marked critical at sign-off. null when the report is not yet completed; true/false once completed.

required string ReportID

Unique report identifier. Format: rep_{32-hex-chars}

required StudyReportMetadata SnapshotMetadata

Patient demographics and scan information for report generation

string Age

Patient’s age at study date (e.g., ‘34.5 years’, ‘2 months’)

string DateOfBirth

Patient’s date of birth. Format: YYYY-MM-DD (e.g., ‘1990-05-20’)

string FacilityName

Name of the medical facility where the scan was performed

Height Height

Patient’s height with unit (e.g., {value: 70, unit: ‘inches’} or {value: 178, unit: ‘cm’})

required HeightUnit Unit

Unit of measure for a height value. ‘in’ = inches, ‘cm’ = centimeters.

One of the following:

required Double Value

minimum0

string Mrn

Medical Record Number - unique patient identifier

string PatientName

Full name of the patient

string Procedure

Procedure or study type (e.g., ‘MRI Brain with Contrast’). Maps to database scan_type and dictation report_header.scan_type.

string ReferringPhysicianName

Name of the physician who referred the patient for this scan

Sex Sex

Patient’s biological sex. Options: ‘male’, ‘female’, ‘other’

One of the following:

string StudyDate

Study date (YYYY-MM-DD). Maps to database scan_date and dictation report_header.scan_date.

string StudyTime

Study time (HH:MM). Maps to database scan_time and dictation report_header.scan_time.

Weight Weight

Patient’s weight with unit (e.g., {value: 150, unit: ‘lbs’} or {value: 68, unit: ‘kg’})

required WeightUnit Unit

Unit of measure for a weight value. ‘lbs’ = pounds, ‘kg’ = kilograms.

One of the following:

required Double Value

minimum0

required string StudyID

Study ID this report belongs to. Format: stu_{32-hex-chars}

required string StudyInstanceUid

DICOM Study Instance UID. Must be a valid DICOM UID format (e.g., ‘1.2.840.10008.5.1.4.1.1.2’)

minLength1

string PlainText

Plain text content of the report