Webhooks

ModelsExpand Collapse

ReportDeliveredEvent = object { id, data, type }

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

id: string

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

data: object { presignedUrl, reportId, studyId, plainText }

Event payload containing report and study information

presignedUrl: string

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

formaturi

reportId: string

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

studyId: string

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

plainText: optional string

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

type: "report.delivered"

Event type identifier

ReportDeliveredResponse = object { success }

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

success: boolean

Acknowledgment of receipt. Return true to confirm delivery.

StudyAccessRequestedEvent = object { id, data, type }

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.

id: string

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

data: object { studyId, studyInstanceUid }

Event payload containing study information

studyId: string

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

studyInstanceUid: string

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

type: "study.access_requested"

Event type identifier

StudyAccessRequestedResponse = object { authorized, urls, error }

Response expected by Avara for study access webhook. Provide presigned URLs for DICOM images.

authorized: boolean

Whether access is authorized for this study

urls: array of string

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

error: optional string

Error message if authorization failed or URLs cannot be provided

WebhookEvent = StudyAccessRequestedEvent { id, data, type } or ReportDeliveredEvent { id, data, type }

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

Accepts one of the following:

StudyAccessRequestedEvent = object { id, data, type }

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.

id: string

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

data: object { studyId, studyInstanceUid }

Event payload containing study information

studyId: string

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

studyInstanceUid: string

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

type: "study.access_requested"

Event type identifier

ReportDeliveredEvent = object { id, data, type }

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

id: string

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

data: object { presignedUrl, reportId, studyId, plainText }

Event payload containing report and study information

presignedUrl: string

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

formaturi

reportId: string

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

studyId: string

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

plainText: optional string

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

type: "report.delivered"

Event type identifier

UnwrapWebhookEvent = StudyAccessRequestedEvent { id, data, type } or ReportDeliveredEvent { id, data, type }

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.

Accepts one of the following:

StudyAccessRequestedEvent = object { id, data, type }

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.

id: string

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

data: object { studyId, studyInstanceUid }

Event payload containing study information

studyId: string

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

studyInstanceUid: string

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

type: "study.access_requested"

Event type identifier

ReportDeliveredEvent = object { id, data, type }

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

id: string

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

data: object { presignedUrl, reportId, studyId, plainText }

Event payload containing report and study information

presignedUrl: string

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

formaturi

reportId: string

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

studyId: string

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

plainText: optional string

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

type: "report.delivered"

Event type identifier