Skip to main content
GET
List the synthesis queue
Returns one page of the synthesis queue in this deployment’s workspace. Each row is the SynthesisRequest plus its enrichment: the triggering workflow’s name, a procedure request’s input and output signature, and, for a request in awaiting_review, up to five possible duplicates (a completed or provisional request for the same specification, or a catalog procedure with the same signature). data.count is the number of rows on the page. Filters are status (default provisional; all lists every status), kind (skill, agent or procedure), reviewerAssignedTo (a reviewer subject) and factoryId. Rows are newest first within a status; with all they are ordered by status, then newest first. limit is 1 to 50 (default 25) and cursor is the previous page’s meta.nextCursor. Each page reads at most limit requests and then applies kind and factoryId, so a page can hold fewer rows than limit, or none, while meta.hasMore is still true: keep following meta.nextCursor until meta.hasMore is false. A malformed factoryId returns an empty last page; a well-formed factoryId that names no factory matches no row, so its pages come back empty while meta.hasMore is true. Each parameter may appear at most once. A repeat, an invalid status or kind, an empty value, a limit outside 1 to 50 or a malformed cursor answers 400 bad_request. Needs platform:read at the platform scope: a grant that covers only some org units receives 403. A row never names who asked for the request, who held it or who assigned its reviewer.

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

status
enum<string>
default:provisional

Only requests in this status; all lists every status. Default provisional.

Available options:
pending,
dispatched,
building,
awaiting_approval,
deferred,
provisional,
awaiting_review,
rejected,
deduped,
completed,
failed,
all
kind
enum<string>

Only requests for this primitive kind.

Available options:
skill,
agent,
procedure
reviewerAssignedTo
string

Only requests assigned to this reviewer subject.

Minimum string length: 1
factoryId
string

Only requests from this factory.

Minimum string length: 1
limit
integer
default:25

Requests read 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 the synthesis queue

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.