Skip to main content
POST
Promote provisional synthesis requests
Promotes each provisional request, as the Console’s Promote does: the request becomes completed, its primitive is approved and replaces the one it supersedes, and a procedure’s lifecycle records the promotion. A request in any other status is skipped as wrong_status. An improve request whose version a later improvement already superseded is skipped as improved_version_not_eligible, and nothing is approved for it. One audit event records the call. The body is strict: ids holds 1 to 50 request ids, each non-empty and none repeated, otherwise 400 “ids must hold 1-50 unique ids”; an unknown field is 400. One call is one transaction: if it fails, nothing was written and the answer is 500. Otherwise the answer is 200 with {requested, affected, skipped}, where skipped lists each unchanged id in the order sent with its reason, and affected plus the length of skipped equals requested. Needs synthesis:approve at the platform scope: a grant that covers only some org units receives 403, and nothing is written. A Personal key decides as its owner, through each request’s human task: an id whose task does not ask the owner, through the key’s scopes, is skipped as not_a_candidate, and one someone else claimed as claimed_by_other. An External App or platform key is recorded as itself, with who gave its grant (see Who decided), and closes each decided request’s open human task. The response never names who decided. Without a key, a repeat changes nothing: each id already moved is skipped as wrong_status. Send an Idempotency-Key to make a retry safe: the same key and body within 24 hours returns the recorded 200 only while you still hold synthesis:approve at the platform scope; otherwise 409 idempotency_result_unavailable, and the decision never runs twice. The same key with a different body is 422. If an outcome is unknown, repeat with the same key or read the requests with Get synthesis request; never retry under a new key.

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.

Headers

Idempotency-Key
string

Optional logical intent key. A same-key retry within 24 hours returns the recorded result without writing again.

Required string length: 1 - 255

Body

application/json
ids
string[]
required

The synthesis request ids, 1 through 50, each non-empty and none repeated.

Required array length: 1 - 50 elements
Minimum string length: 1

Response

One outcome per id

data
object
required
meta
object
required