Record that a source was checked for this action's signal.

result is found, not_found_in_source or cannot_check. not_found_in_source REQUIRES source { kind, detail } AND period { from, to } — otherwise 400 CHECK_SCOPE_REQUIRED, because a statement without a scope would read as a claim about a third party. cannot_check REQUIRES reason (no_access, source_unknown, needs_human); with no_access a NEW delegation is opened for the same source and period, requiring the missing capability. found closes NOTHING and records NO signal: without signalId the check carries pending_link true and next_move points at POST /actions/{id}/satisfy-signal. Every check records its actor and one domain event, and can never be edited or deleted. The number of checks NEVER escalates anything.

post/actions/{id}/signal-checks

Request

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

Path parameters

idstring required

Request body

looked_forstring
result'found' | 'not_found_in_source' | 'cannot_check'
reason'no_access' | 'source_unknown' | 'needs_human' nullable
notestring nullable
evidenceIdstring nullable
signalIdstring nullable

Response

Check recorded; the action's lifecycle is unchanged

okboolean
checkobject
actionobject
meansstring
next_moveobject nullable
delegationobject nullable

Changes

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