Skip to main content

Asset API Summary

Summary

Epic 13.3 verified 31 method/route pairs across the asset-service. This page groups them by purpose so readers can orient quickly; it does not re-list every pair. For the full catalog with methods, paths, and payloads, follow the cross-links to the authoritative API documentation.

Audience

Developers and QA engineers integrating with the service, support engineers tracing a call, and solution architects assessing the surface area.

Reference Content

Endpoint groups

GroupPurposePath family
Native assetCreate, list, detail, update, and status changes for assets./asset/*
AssignmentAssign an asset and record assignment./asset/*
Request and approvalRaise a request and drive approval (direct or managed)./asset/*
DocumentsAttach, list, download, and remove document references./asset/*
WorkflowIdempotent inbound workflow callback./asset/*
CompatibilityMonolith-shaped HR Operations surface./api/hr-operations/*
Health and foundationHealth, service info, health-data, and outbox inspection./health, service-info, /asset/*

Native endpoints live under /asset/*; the compatibility surface mirrors the legacy shape under /api/hr-operations/*. The two surfaces coexist during the transitional period.

Authorization posture

Native and compatibility endpoints are anonymous and tenant-scoped rather than role-authorized. Tenant context is required, and self-service reads are narrowed to the caller's labor id at the gateway. See the Permissions Matrix for the per-action breakdown.

Source References

  • microservices/src/asset-service/Api/AssetEndpoints.cs
  • microservices/src/asset-service/Api/AssetCompatEndpoints.cs
  • microservices/src/asset-service/Application/Commands/AssetCommands.cs

See Also

Keywords

asset api, endpoints, compatibility, native surface, tenant-scoped

Revision Information

  • Status: Draft
  • Last reviewed: 2026-07-17
  • Review cycle: Quarterly