Skip to main content
GET
List the judge verdicts on a subject
Returns the verdicts on one subject as data.verdicts, newest first, a page at a time. Each carries its label, score, confidence, rationale, its per-criterion scores as perCriterion entries, and at most 10 findings; findingCount is the full count. A finding’s suggestedAction.targetRoute is a Forge Console path, and its targetParams are {key, value} entries. limit is 1-100, default 20; a larger value is 400 too_big. While meta.hasMore is true, pass meta.nextCursor as cursor (with the same other parameters) for the next page; a cursor sent with another route, other parameters or another credential, or altered, is 400. With judgeId, each page’s verdicts are read and then filtered to that judge, so a page may hold fewer verdicts than limit, or none, while more remain. The list never answers meta.partial. subjectKind is one of skill, agent, procedure, workflow_graph or workflow_run, and subjectId is that subject’s stored key (see Subjects). Each parameter may appear at most once; a missing or invalid subjectKind, a missing subjectId or an empty judgeId is 400 bad_request. The read filters, so an unknown subject is empty, never 404. A PERSONAL agent, or one that no longer exists, is never a readable subject: for subjectKind=agent naming one, the answer is empty. Needs grants:read, policies:read and audit:read at the platform scope: a grant that covers only some org units receives 403, naming the first one missing.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

subjectId
string
required

The subject's stored key.

Minimum string length: 1

Query Parameters

subjectKind
enum<string>
required

The kind of subject.

Available options:
skill,
agent,
procedure,
workflow_graph,
workflow_run
judgeId
string

Only this judge's verdicts.

Minimum string length: 1
limit
integer
default:20

Items per page, 1 to 100 (default 20); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

Required range: 1 <= x <= 100
cursor
string

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

The verdicts

data
object
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.