Agents

Get Agent Oversight

What your agents need from a person, and what they did without asking.

Three groups in one read: approvals (work stopped on a decision - each row carries what POST /agent/approvals/{approval_id}/decide needs), blockers (work stopped for another reason, with why) and autonomous_fixes (changes made on your behalf).

AN EMPTY GROUP SAYS WHY. Read states: ready means the read worked and there is nothing, unavailable means the read failed, not_recorded means nothing is ever recorded there for this org (no skill is dialled to act on its own). Every group is capped at limit and says so in bounds.

get/agent/oversight

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/agent/oversight
  • Auth: HTTP bearer

Query parameters

limitinteger

Max rows PER GROUP.

fix_window_hoursinteger

How far back autonomous fixes are read.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataAgentConversationPayload required

An open envelope for the app's answer.

Open because the chat answer (kind, message, chips, sources, work_item_id, ...) and the oversight feed (approvals, blockers, autonomous_fixes, states, bounds) are both still growing, and a dropped field on an agent surface is one the caller does not know they lost.

Changes

No recorded changes to this operation across all 2 revisions of this API.