Auto-generated. This article is rebuilt from FastAPI route introspection by scripts/build_api_kb.py. Edit the route docstring in app/ and re-run the script — do not edit this file directly.

POST /api/v1/screener/promote

Handler: app.screener.routes.promote_screener_candidate
Methods: POST

Description

Promote-to-watchlist intent stub.

Records the operator’s intent via logger.info and returns a typed 200 confirming receipt. No DB write occurs — this avoids adding a new retention-guard surface before Phase 5 designs the company layer that will act on the promotion.

Validation:

• ticker must be non-empty (400 when empty or whitespace-only).
• archetype is optional context; no validation performed here.

The real watchlist integration (co_entity seeding, deep-pull scheduling, status update to "promoted" in screener_candidates) is deferred to Phase 5, Session 5.x.

Curl

curl -s https://bigclawd.com/api/v1/screener/promote