Agent

Record a finding for the rest of this run to read (T880)

The mid-run channel: what one agent learned, readable by its siblings BEFORE it lands its diff. A finding is one claim plus its evidence, not a session summary — that is the handoff. workspace is required rather than defaulting to GLOBAL, so a fan-out's working notes never pour into the workspace shared by every project on the tenant.

post/api/agent/findings

Request

  • Base URL: http://localhost:38200
  • URL: http://localhost:38200/api/agent/findings
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Request body

run_idstring required

The run every agent in this fan-out shares

session_idinteger required
titlestring required

The claim

bodystring required

What was observed

workspacestring required

Response

Finding recorded.

contextIdinteger
runIdstring
sessionIdinteger nullable
titlestring
bodystring
createdAtstring date-time
runKnownboolean

False when the run id was never opened. The write is still accepted — refusing would lose a real finding over a bookkeeping mistake the agent did not make — but the writer learns on the spot that nobody will read it.

Changes

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