Docs

Get Drive Link File

GET /drives/{eventId}/links/{linkId}/files/{fileId}

GET/drives/{eventId}/links/{linkId}/files/{fileId}

Required Tokens

No authentication required. This endpoint is publicly accessible via a shared link — it is intended for external users who have received a link from an event participant.

Returns the full details of a specific file accessible through a public link, including all versions and their formats with download URIs. Use the sasUri on each format to download the file directly from Azure Blob Storage.

Path Parameters

FieldTypeRequiredDescription
driveIdGuidRequiredThe event ID.
linkIdGuidRequiredThe public link ID.
fileIdGuidRequiredThe ID of the file to retrieve. Must be within the link's scope.

Response Fields

FieldTypeDescription
idGuidThe file's unique ID.
namestringDisplay name.
descriptionstringOptional description.
pathstringParent path of the file.
statusstringCurrent file status. See **File Statuses**.
versionsarrayAll versions of the file. See **Version Fields**.

Version Fields

FieldTypeDescription
idGuidVersion ID.
versionTagstringAuto-generated version label (e.g., `"Version 1"`).
createdDateDateTimeWhen this version was created (UTC).
formatsarrayUploaded formats for this version. See **Format Fields**.

Format Fields

FieldTypeDescription
idGuidFormat ID.
typestringMIME type of the uploaded file (e.g., `"application/pdf"`, `"video/mp4"`).
sizeintFile size in bytes.
uristringTime-limited SAS URI for downloading this format directly from Azure Blob Storage.

File Statuses

ValueDescription
NoStatusNo status set (non-deliverable files, or no reviewers assigned).
IncompleteDeliverable with no versions uploaded yet.
AwaitingApprovalReviewers assigned but not all have responded.
ChangesRequestedAt least one reviewer has requested changes.
ApprovedAll reviewers have approved the latest version.

Error Codes

CodeHTTP StatusDescription
NOT_FOUND404Link or file not found.
UNAUTHORIZED401File is not accessible through this link.