interpret_signal: conclude what an already recorded signal MEANS. Requires actual_signal to exist and the action to be unresolved (needs_decision). Never overwrites actual_signal or actual_signal_at, never creates a child action, never resolves the loop — the action normally stays in needs_decision until create_next_action and/or close_loop.

post/actions/{id}/interpret-signal

Request

  • Base URL: https://forbiz.io/api/public/agent
  • URL: https://forbiz.io/api/public/agent/actions/{id}/interpret-signal
  • Auth: HTTP bearer

Path parameters

idstring required

Headers

Idempotency-Keystring

Recommended on every mutating request. A replay with the same key is NOT applied twice: the server answers { ok, idempotent_replay: true, first_seen_at, status } describing the first attempt.

Request body

outcomeStatus'expected' | 'partial' | 'unexpected' | 'deferred' required
learningNotestring
resolvefalse

Must be false or omitted. Resolving is only possible through close-loop.

Response

Interpretation stored; signal untouched

okboolean
notestring

Changes

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