Skip to main content
POST
Close keep-both curator recommendations
Closes each pending recommendation whose Curator recommendation is keep_both as rejected: you confirm the pair are distinct, and neither primitive changes. Takes 1 to 50 unique ids; otherwise 400 “ids must hold 1-50 unique ids”. 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}. skipped lists each unchanged id in the order sent, with its reason:
  • not_found: unknown, malformed or outside the platform workspace;
  • wrong_status: already decided, with the recommendation’s status;
  • not_keep_both: the Curator recommended something else, named as detail.
affected plus the length of skipped equals requested. One audit event records the call. 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. A Personal key decides as its owner, through each recommendation’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, and closes each decided recommendation’s open human task. Without a key, a repeat changes nothing: each id already closed 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 write 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 recommendations with Get curator recommendation; 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