Problem
GOOD_FIRST_ISSUES #38: public routes lack rich OpenAPI docstrings. Ingest (/api/ingest/v1/*) and health are the surfaces external integrators hit first. FastAPI will expose schemas, but summaries/descriptions are thin.
Repository evidence
Proposed direction
Add concise summary/description on 2–4 critical routes (health, ingest open, ingest events, ingest artifact) stating observe-only / redaction required / auth when configured.
Acceptance criteria
Difficulty
S · good first issue
Problem
GOOD_FIRST_ISSUES #38: public routes lack rich OpenAPI docstrings. Ingest (
/api/ingest/v1/*) and health are the surfaces external integrators hit first. FastAPI will expose schemas, but summaries/descriptions are thin.Repository evidence
apps/api/src/mutiny_api/ingest.py/app.pyroute handlersschemas.py/ingest_schemas.pyProposed direction
Add concise
summary/descriptionon 2–4 critical routes (health, ingest open, ingest events, ingest artifact) stating observe-only / redaction required / auth when configured.Acceptance criteria
/openapi.json) shows improved descriptions for chosen routesDifficulty
S · good first issue