Submit Outcome

Submit ground-truth outcome for a prior signed decision record.

Closes the learning loop: evaluate registers the prediction; this endpoint tags it with what actually happened so Brier score and reliability bins accrue on the partner's own book.

post/v1/calibration/outcomes

Request

  • Base URL: https://api.forgeorbital.com
  • URL: https://api.forgeorbital.com/v1/calibration/outcomes
  • Auth: API key in header X-API-Key

Request body

schema_version'forge-outcome/v2' required
record_idstring required

record_id from the signed DecisionRecord.

industrystring required

Same industry key used at evaluate time.

final_outcomestring required

Observed outcome label from the signed decision-option menu.

partner_decisionstring

What the partner actually did, if different from Forge selected_action.

observed_atstring date-time

When the outcome occurred or became observable.

client_idstring

Optional tenant assertion. When supplied, it must exactly match the authenticated org_id.

Response

Successful Response

schema_version'forge-outcome-receipt/v1'
acceptedtrue
updatedboolean required
idempotent_replayboolean
reason'outcome_written' | 'outcome_already_recorded' required
record_idstring required
final_outcomestring required
outcome_event_idinteger nullable
calibration_summaryobject required

Changes

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