docs/API.md

API (v1) - section 14 mapping

Base path /api/v1. Typed request models are in apps/api.py; the OpenAPI schema is served at /docs and /openapi.json. Errors are returned as {"error": <ErrorCode>, "message", "details"} with HTTP 400/409/422/429/503/504.

API	Operation	Endpoint
Project	create_project	POST /projects
	update_goal	PUT /projects/{id}/goal
	set_constraints	PUT /projects/{id}/constraints
	archive_project	POST /projects/{id}/archive?confirm=true
Mission	create_mission	POST /missions
	plan_tasks	POST /missions/{id}/plan
	pause / resume / cancel / branch	POST /missions/{id}/pause, /resume, /cancel?confirm=true, /branch
	(controls) run, approve, reject, change budget	/run, /approve, /reject, /budget
Candidate	generate	POST /candidates/generate
	transform	POST /candidates/{id}/transform
	validate_schema	POST /candidates/validate_schema
	compare	GET /candidates/compare?a=&b=
	export	`GET /candidates/{id}/export?fmt=xyz
Simulation	list_compatible_solvers	GET /simulation/compatible?candidate_id=&observable=
	estimate_cost	GET /simulation/estimate
	submit_run	POST /simulation/runs
	get_status	GET /simulation/jobs/{job_id}
	fetch_artifacts	GET /simulation/runs/{run_id}/artifacts, GET /artifacts/{id}
Agent	assign_task	POST /agents/assign_task?role=&mission_id=&stage=
	send_message	POST /agents/messages
	publish_result	POST /agents/publish_result
	request_review	POST /agents/request_review
Evidence	compute_maturity	POST /evidence/{candidate_id}/maturity
	attach_claim	POST /evidence/{candidate_id}/claims
	request_replication	POST /evidence/{candidate_id}/replication?run_id=
	compare_sources	POST /evidence/compare_sources
Knowledge	propose_event	POST /knowledge/events
	verify_event	POST /knowledge/events/{fact_id}/verify
	search_graph	GET /knowledge/search
	get_lineage	GET /knowledge/lineage/{candidate_id}
Resource	get_capacity	GET /resources/capacity
	allocate	POST /resources/allocate (+ /release)
	checkpoint	POST /resources/checkpoint/{job_or_mission_id}
	enforce_quota	POST /resources/enforce_quota
Export	export_structure	GET /export/structure/{candidate_id}
	export_run_bundle	GET /export/run/{run_id}
	export_report	`GET /export/report/{mission_id}?fmt=md
	export_project	GET /export/project/{project_id}

Extras: /simulation/solvers, /simulation/plan, /agents (roster), /agents/evaluations, /agents/benchmarks, /agents/improvements/{id}/deploy|rollback, /evidence/benchmarks, /knowledge/status_counts, /knowledge/sources, /resources/snapshot, /resources/integrity, /resources/queue, /control/pause_all, /observability/audit|metrics|failures, /viewer/{candidate_id}, /dashboard/summary.

Schema versions: data contracts 1.0.0 (core/schemas.SCHEMA_VERSION); DB migrations 0001_initial, 0002_immutability_triggers.