Skip to content

Get Agent Oversight

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.

Authorizations

Parameters

Query Parameters

limit

Max rows PER GROUP.

integer
default: 50 >= 1 <= 200

Max rows PER GROUP.

fix_window_hours

How far back autonomous fixes are read.

integer
default: 24 >= 1 <= 720

How far back autonomous fixes are read.

Header Parameters

X-Target-Org-Id
Any of:
string

Responses

200

Successful Response

object
data
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.

object
key
additional properties
any
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
notes
Any of:
Array<string>
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer
total_available
Any of:
integer
total_is_lower_bound
Any of:
boolean

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string