Skip to main content
GET
List pending curator recommendations
Returns one page of the Curator’s pending recommendations as data.recommendations, newest first. A recommendation pairs two skills, agents or procedures the Curator judged to overlap, with what it recommends (merge, deprecate_a, deprecate_b or keep_both), the duplicate judge’s score, label and confidence, and the pair’s cosine similarity. kind lists one primitive kind; limit is 1-50 (default 25). Follow meta.nextCursor while meta.hasMore is true. The queue is the Console’s: the recommendations the Curator records for the platform workspace. A recommendation never carries its workspace, its judge verdict row, its curator run or who reviewed it. Each parameter may appear at most once; a repeat, an invalid kind, a limit outside 1-50 or a malformed cursor is 400 bad_request. Needs synthesis:approve at the platform scope, the reads included (the Console’s curator queue requires it): a grant that covers only some org units receives 403, and nothing is read or written. A Forge agent can never hold it.

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.

Query Parameters

kind
enum<string>

Only recommendations about this primitive kind.

Available options:
skill,
agent,
procedure
limit
integer
default:25

Recommendations per page, 1-50. Default 25.

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

The opaque meta.nextCursor from the previous page.

Minimum string length: 1

Response

One page of pending recommendations

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.