Auto Scribe

ModelsExpand Collapse

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.

Accepts 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'

Accepts 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.

Accepts 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 WeightUnit:

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

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.

Accepts one of the following:

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.

Accepts 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'

Accepts 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.

Accepts one of the following:

required Double Value

minimum0

required ReportStatus Status

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

Accepts 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.

Accepts 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'

Accepts 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.

Accepts 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.

Accepts 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'

Accepts 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.

Accepts 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