Submit a bounded outcome for one routed decision

Accepts only canonical low-trust outcome kinds under a signed tenant-bound token. Stale, revoked, paid-plan, sampled-out, or operator-disabled learning produces collected=false and no training row.

post/v1/route/outcomes

Request

  • Base URL
    https://gateway.caveman.so
  • URL
    https://gateway.caveman.so/v1/route/outcomes
  • Auth
    API key in header x-cave-api-key

Request body

outcome_tokenstring required
outcome_kind'retry' | 'test_pass' | 'test_fail' | 'abandoned' | 'completed' | 'failed' | 'interrupted' | 'accepted' | 'rejected' required

A delegated task's outcome is completed, failed or interrupted, and a reviewer agent's verdict on it accepted or rejected.

Response

Outcome accepted; collected states whether a durable learning row was admitted.

acceptedunknown required
collectedboolean required
event_idstring

Changes

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