← Home Specs Ideas Contributors Flow Contribute

Spec assets-api

Edit

Spec: Assets API

Spec Source

inventory_source local | spec_api /api/spec-registry/assets-api | registry_updated 2026-04-09T03:10:08.818591Z

Open spec API record

Spec Value/Cost/Gap Sensing

potential_value 0.00 | actual_value 1.00 | value_gap 0.00

estimated_cost 0.00 | actual_cost 1.00 | cost_gap 1.00

estimated_roi 0.00 | actual_roi 1.00

Linked Ideas

value-attribution

Linked Contributors

Missing contributor linkage. Submit a change request with contributor attribution.

Linked Process

Open process view for this spec

task_ids -

branches -

source_files -

evidence_refs -

Linked Implementation

Open implementation view for this spec

implementation_refs -

lineage_ids -

public_endpoints -

Spec Summary + Process + Pseudocode + Implementation Notes

summary Manage assets (code, models, content, data) that receive contributions. Assets accumulate total_cost as contributions are recorded. Core entity in the value distribution system.

process_summary POST /api/assets — Create new asset; GET /api/assets/{id} — Retrieve asset by ID (404 if not found); GET /api/assets — List all assets with pagination (limit parameter); Asset types: CODE, MODEL, CONTENT, DATA; total_cost auto-updates when contributions are recorded

pseudocode_summary -

implementation_summary api/app/routers/assets.py (create_asset(), get_asset(), list_assets()); api/app/models/asset.py (Asset, AssetCreate, AssetType)