Skip to main content

DownloadAccess

Description

Row-level permission grant for a Principal to download a DigitalAsset. Represents the "fulfillment" of a digital order line item. Uses Spring ACL for object-level enforcement; backed by ValkyrAclService.grantPermission(). Access is granted automatically when an OrderFulfillmentTask completes successfully.

Properties

NameTypeDescriptionNotes
digitalAssetIdUUIDDigitalAsset this access unlocks.
digitalAssetDigitalAsset[optional]
principalIdUUIDPrincipal (customer/user) granted access.
principalPrincipal[optional]
salesOrderLineItemIdUUIDReference to the LineItem that triggered this access grant. Links order fulfillment to access control.
downloadTokenUUIDSecure, single-use token for download link generation. Regenerated on each DownloadAccess read to support multiple concurrent downloads.[optional]
downloadCountIntegerNumber of times this access has been used to download.[optional]
maxDownloadsRemainingIntegerRemaining downloads (-1 = unlimited). Decremented on each successful download; access revoked when zero.[optional]
grantedAtOffsetDateTimeWhen access was granted (auto-filled by backend).[optional]
expiresAtOffsetDateTimeWhen download access expires (null = never expires).[optional]
lastDownloadedAtOffsetDateTimeTimestamp of the most recent download.[optional]
revokedAtOffsetDateTimeIf revoked, timestamp of revocation (soft-delete).[optional]
revokedReasonStringReason for revocation (e.g., refund, chargeback, policy violation).[optional]
idUUIDUnique identifier for object in the system[optional] [readonly]
ownerIdUUIDUUID of owner of the object in the system[optional] [readonly]
createdDateOffsetDateTimeDate of object creation[optional] [readonly]
keyHashStringData, including hash of the key(s) used to encrypt this record.[optional] [readonly]
lastAccessedByIdUUIDLast user to access object[optional] [readonly]
lastAccessedDateOffsetDateTimeTimestamp of last access of object[optional] [readonly]
lastModifiedByIdUUIDUnique identifier for user who last modifed the object in the system[optional] [readonly]
lastModifiedDateOffsetDateTimeDate of last object modification[optional] [readonly]

Implemented Interfaces

  • Serializable

Generated Version Details

~value
GENERATOR VERSIONcom.valkyrlabs:ValkyrAI API 1.0.1-SNAPSHOT
API ARTIFACTcom.valkyrlabs.valkyrai-api.jar
GENERATOR VERSIONorg.openapitools.openapi-generator:7.5.0
GENERATOR CLASSorg.openapitools.codegen.languages.SpringCodegen
GENERATED DATE2025-12-03T11:13:18.492704-08:00[America/Los_Angeles]