Skip to main content
GET
List procedures held for operator review
Returns the draft procedures the Builder holds for operator review, newest hold first, at most 100. A hold is a draft whose interactive refine could not finish on its own; it has no synthesis request. Each hold is procedureId, procedureRowId, name, version when set, the hold’s reason and heldAt. meta.partial is true when more holds exist than were returned, or when the scan of draft procedures reached its read limit. It takes only limit and cursor, to page the list. Holds are listed only. A held draft is approved or sent back on the procedure itself, in the Console’s Procedures page; the synthesis decisions do not act on it. Needs platform:read at the platform scope: a grant that covers only some org units receives 403.

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

limit
integer
default:50

Items per page, 1 to 100 (default 50); 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 held procedures

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.