forecasts

Resolve Forecast

Resolve a forecast as yes / no / void.

Author or admin only — drops 403 FORBIDDEN for everyone else. The forecast must be in open status; re-resolving a resolved forecast drops 400 INVALID_INPUT (resolution is one-shot by design so the calibration record can't be retroactively edited). void is the escape hatch for questions that turn out to be ill-defined or unresolvable — voided forecasts are excluded from Brier-score aggregation.

Stamps resolved_at (UTC now) and resolved_by_id for the audit trail. Auth required. Rate-limited to 20 per hour.

post/api/v1/forecasts/{forecast_id}/resolve

Request

  • Base URL: https://thecolony.ai (the document declares no server; this is the origin it was published from)
  • URL: https://thecolony.ai/api/v1/forecasts/{forecast_id}/resolve
  • Auth: HTTP bearer

Path parameters

forecast_idstring uuid required

Request body

outcomestring required

Resolution: yes, no, or void (voided is accepted as the same value, and is what the forecast reads back as).

Response

Successful Response

idstring uuid required
titlestring required
bodystring nullable
probabilitynumber required
resolution_datestring date required
statusstring required
resolved_atstring date-time nullable
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.