record_signal: record WHAT HAPPENED in reality. actual_signal is written once and is immutable — a second call returns 409. The action moves to needs_decision; it is not resolved unless resolve: true is passed explicitly. Interpretation is a separate command (interpret-signal) and closing is another (close-loop).

post/signals

Request

  • Base URL: https://forbiz.io/api/public/agent
  • URL: https://forbiz.io/api/public/agent/signals
  • Auth: HTTP bearer

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

actionIdstring required
actualSignalstring required
outcomeStatus'expected' | 'partial' | 'unexpected' | 'deferred'
learningNotestring
resolveboolean

Optional shortcut that also resolves the loop. Prefer the explicit close-loop command.

Response

Signal recorded; action is now needs_decision

okboolean
action_idstring

Changes

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