Generate a viewer reroute URL

POST/v1/viewer/studies/reroute-url

Generates a tokenized URL that redirects users directly to the Avara Viewer for the specified study. The URL includes authentication and is time-limited for security.

Body ParametersJSONExpand Collapse

studyId: optional string

Unique study identifier. Format: stu_{32-hex-chars}

studyInstanceUid: optional string

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

minLength1

ReturnsExpand Collapse

url: string

Generate a viewer reroute URL

curl https://api.avarasoftware.com/v1/viewer/studies/reroute-url \
    -X POST \
    -H "Authorization: Bearer $AVARA_API_KEY"

{
  "url": "https://viewer.avarasoftware.com/study/stu_1234?token=abc123"
}

Returns Examples

{
  "url": "https://viewer.avarasoftware.com/study/stu_1234?token=abc123"
}