Skip to main content

Asset Document API

Document flow

Method and routeBehaviorVerified outcomes
POST /asset/assets/{asset}/documentsValidate/decode content, store bytes externally, persist local referenceCreated, bad request, not found, service unavailable
GET /asset/assets/{asset}/documentsList local referencesSuccess or not found
GET /asset/assets/{asset}/documents/{document}/downloadResolve local reference and stream externally owned bytesFile, not found, or service unavailable
DELETE /asset/assets/{asset}/documents/{document}Remove local reference onlySuccess or not found

Asset Service owns association metadata; Document Service owns bytes. Removal retains external storage. Versioning, replacement, external deletion, malware-scanning evidence, retention actions, and document-specific authorization are Not implemented.

Classification

The API is Transitional. Capabilities explicitly described as absent are Not implemented. Host diagnostics and evidence routes are Foundation. Production exposure, ownership, and governance Require confirmation.

Source References

  • microservices/src/asset-service/Api/AssetEndpoints.cs
  • microservices/src/asset-service/Application/Commands/DocumentCommands.cs
  • microservices/src/asset-service/Application/DocumentIntegration.cs
  • microservices/src/asset-service/Infrastructure/AssetDocumentGateway.cs