---
title: "Record that a source was checked for this action's signal."
method: POST
path: "/actions/{id}/signal-checks"
---

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

`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

`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.

## Path parameters

- `id` string, required

## Request body

- object
  - `source` object
    - `kind` string
    - `detail` string
  - `period` object
    - `from` string, date-time
    - `to` string, date-time
  - `looked_for` string
  - `result` 'found' | 'not_found_in_source' | 'cannot_check'
  - `reason` 'no_access' | 'source_unknown' | 'needs_human', nullable
  - `note` string, nullable
  - `evidenceId` string, nullable
  - `signalId` string, nullable

## Response `201`

Check recorded; the action's lifecycle is unchanged

- object
  - `ok` boolean
  - `check` object
  - `action` object
  - `means` string
  - `next_move` object, nullable
  - `delegation` object, nullable

## Other responses

- `400`: CHECK_SCOPE_REQUIRED / CHECK_REASON_REQUIRED / INVALID_CHECK_RESULT / INVALID_CHECK_PERIOD / LOOKED_FOR_REQUIRED / EVIDENCE_NOT_FOUND / SIGNAL_NOT_FOUND
- `404`: ACTION_NOT_FOUND

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)