Skip to content
Avara
Get started
API Reference

Webhooks

ModelsExpand Collapse
class ReportDeliveredEvent:

Webhook event sent when a report is completed. This is an asynchronous notification - respond with a simple acknowledgment.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required ReportDeliveredEventData Data

Event payload containing report and study information

required Boolean IsCritical

Whether the report was marked critical at sign-off.

required string PresignedUrl

Presigned URL for PDF download. Time-limited, typically valid for 1 hour.

formaturi
required string ReportID

Avara report ID. Format: rep_{32-hex-chars}

required string StudyID

Avara study ID. Format: stu_{32-hex-chars}

string PlainText

Report plain text content (optional). Contains the full report text.

JsonElement Type "report.delivered"constant

Event type identifier

class ReportDeliveredEventData:

Event payload containing report and study information

required Boolean IsCritical

Whether the report was marked critical at sign-off.

required string PresignedUrl

Presigned URL for PDF download. Time-limited, typically valid for 1 hour.

formaturi
required string ReportID

Avara report ID. Format: rep_{32-hex-chars}

required string StudyID

Avara study ID. Format: stu_{32-hex-chars}

string PlainText

Report plain text content (optional). Contains the full report text.

class ReportDeliveredResponse:

Response expected by Avara for report delivery webhook. Simple acknowledgment.

required Boolean Success

Acknowledgment of receipt. Return true to confirm delivery.

class SecondaryCaptureAccessRequestedEvent:

Webhook event sent when Avara needs presigned UPLOAD URLs for a secondary capture DICOM. This is a synchronous webhook - you must respond with the upload URLs within the request timeout.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required SecondaryCaptureAccessRequestedEventData Data

Event payload containing study + (optional) series/SOP information for a secondary capture upload

required string StudyID

Avara study ID. 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')

string SeriesInstanceUid

DICOM Series Instance UID generated for the new secondary capture series (when available).

string SopInstanceUid

DICOM SOP Instance UID generated for the new secondary capture object (when available).

JsonElement Type "secondary_capture.access_requested"constant

Event type identifier

class SecondaryCaptureAccessRequestedEventData:

Event payload containing study + (optional) series/SOP information for a secondary capture upload

required string StudyID

Avara study ID. 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')

string SeriesInstanceUid

DICOM Series Instance UID generated for the new secondary capture series (when available).

string SopInstanceUid

DICOM SOP Instance UID generated for the new secondary capture object (when available).

class SecondaryCaptureAccessRequestedResponse:

Response expected by Avara for the secondary capture webhook. Provide presigned PUT URLs the viewer will upload the DICOM to.

required Boolean Authorized

Whether the secondary capture upload is authorized for this study

required IReadOnlyList<string> UploadUrls

Presigned PUT URLs for uploading the secondary capture DICOM. The viewer uploads the same object to every URL.

string ContentCreatorName

Optional content creator name. Avara derives this server-side; this field is ignored if provided.

string Error

Error message if authorization failed or upload URLs cannot be provided

class StudyAccessRequestedEvent:

Webhook event sent when Avara needs presigned URLs for DICOM images. This is a synchronous webhook - you must respond with the URLs within the request timeout.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required StudyAccessRequestedEventData Data

Event payload containing study information

required string StudyID

Avara study ID. 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')

JsonElement Type "study.access_requested"constant

Event type identifier

class StudyAccessRequestedEventData:

Event payload containing study information

required string StudyID

Avara study ID. 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')

class StudyAccessRequestedMediaUrl:

Presigned URL for non-DICOM media (images, PDFs, videos)

required string MimeType

MIME type of the media file (e.g., application/pdf, image/jpeg, video/mp4)

required string Url

Presigned URL to download the media file

formaturi
string FileName

Optional display name for the media file

class StudyAccessRequestedResponse:

Response expected by Avara for study access webhook. Provide presigned URLs for DICOM images and optionally for non-DICOM media.

required Boolean Authorized

Whether access is authorized for this study

required IReadOnlyList<string> Urls

Flat list of presigned URLs for DICOM images. Include all image URLs for the study.

string Error

Error message if authorization failed or URLs cannot be provided

IReadOnlyList<StudyAccessRequestedMediaUrl> MediaUrls

Optional presigned URLs for non-DICOM media (images, PDFs, videos) associated with the study.

required string MimeType

MIME type of the media file (e.g., application/pdf, image/jpeg, video/mp4)

required string Url

Presigned URL to download the media file

formaturi
string FileName

Optional display name for the media file

class WebhookEvent: A class that can be one of several variants.union

Union of all Avara webhook event types. Use the 'type' field to discriminate between event types. Events: study.access_requested (synchronous), report.delivered (asynchronous), secondary_capture.access_requested (synchronous).

class StudyAccessRequestedEvent:

Webhook event sent when Avara needs presigned URLs for DICOM images. This is a synchronous webhook - you must respond with the URLs within the request timeout.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required StudyAccessRequestedEventData Data

Event payload containing study information

required string StudyID

Avara study ID. 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')

JsonElement Type "study.access_requested"constant

Event type identifier

class ReportDeliveredEvent:

Webhook event sent when a report is completed. This is an asynchronous notification - respond with a simple acknowledgment.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required ReportDeliveredEventData Data

Event payload containing report and study information

required Boolean IsCritical

Whether the report was marked critical at sign-off.

required string PresignedUrl

Presigned URL for PDF download. Time-limited, typically valid for 1 hour.

formaturi
required string ReportID

Avara report ID. Format: rep_{32-hex-chars}

required string StudyID

Avara study ID. Format: stu_{32-hex-chars}

string PlainText

Report plain text content (optional). Contains the full report text.

JsonElement Type "report.delivered"constant

Event type identifier

class SecondaryCaptureAccessRequestedEvent:

Webhook event sent when Avara needs presigned UPLOAD URLs for a secondary capture DICOM. This is a synchronous webhook - you must respond with the upload URLs within the request timeout.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required SecondaryCaptureAccessRequestedEventData Data

Event payload containing study + (optional) series/SOP information for a secondary capture upload

required string StudyID

Avara study ID. 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')

string SeriesInstanceUid

DICOM Series Instance UID generated for the new secondary capture series (when available).

string SopInstanceUid

DICOM SOP Instance UID generated for the new secondary capture object (when available).

JsonElement Type "secondary_capture.access_requested"constant

Event type identifier

class UnsafeUnwrapWebhookEvent: A class that can be one of several variants.union

Webhook event sent when Avara needs presigned URLs for DICOM images. This is a synchronous webhook - you must respond with the URLs within the request timeout.

class StudyAccessRequestedEvent:

Webhook event sent when Avara needs presigned URLs for DICOM images. This is a synchronous webhook - you must respond with the URLs within the request timeout.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required StudyAccessRequestedEventData Data

Event payload containing study information

required string StudyID

Avara study ID. 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')

JsonElement Type "study.access_requested"constant

Event type identifier

class ReportDeliveredEvent:

Webhook event sent when a report is completed. This is an asynchronous notification - respond with a simple acknowledgment.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required ReportDeliveredEventData Data

Event payload containing report and study information

required Boolean IsCritical

Whether the report was marked critical at sign-off.

required string PresignedUrl

Presigned URL for PDF download. Time-limited, typically valid for 1 hour.

formaturi
required string ReportID

Avara report ID. Format: rep_{32-hex-chars}

required string StudyID

Avara study ID. Format: stu_{32-hex-chars}

string PlainText

Report plain text content (optional). Contains the full report text.

JsonElement Type "report.delivered"constant

Event type identifier

class SecondaryCaptureAccessRequestedEvent:

Webhook event sent when Avara needs presigned UPLOAD URLs for a secondary capture DICOM. This is a synchronous webhook - you must respond with the upload URLs within the request timeout.

required string ID

Unique webhook event ID. Format: whe_{32-hex-chars}

required SecondaryCaptureAccessRequestedEventData Data

Event payload containing study + (optional) series/SOP information for a secondary capture upload

required string StudyID

Avara study ID. 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')

string SeriesInstanceUid

DICOM Series Instance UID generated for the new secondary capture series (when available).

string SopInstanceUid

DICOM SOP Instance UID generated for the new secondary capture object (when available).

JsonElement Type "secondary_capture.access_requested"constant

Event type identifier