Skip to main content
POST
Decide a curator recommendation
Decides one pending recommendation, as the Console queue does:
  • merge keeps primitive A and deprecates B;
  • deprecate_a or deprecate_b deprecates that primitive (a procedure through its lifecycle);
  • keep_both and mark_distinct change neither primitive.
The first three close the recommendation approved, the last two rejected. reviewerNote, at most 2,000 characters, is recorded on it. The answer is 200 with the decided data.recommendation. One call is one transaction: if a primitive cannot be read or written, nothing is written and the answer is 500. A primitive that no longer exists is not deprecated, and the recommendation still closes, as in the Console. A recommendation already decided is 409 invalid_state “Recommendation already resolved (<status>)”, and nothing is written. An empty, malformed or unknown id, or one outside the platform workspace, answers 404 resource_missing “Curator recommendation not found”. The body is strict: an unknown field or decision is 400. 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 the recommendation’s human task: a task that does not ask the owner, through the key’s scopes, answers 403 forbidden, and one someone else claimed 409 conflict. An External App or platform key is recorded as itself, with who gave its grant (see Who decided), and closes the recommendation’s open human task. Without a key, a repeat is 409: the recommendation is already resolved. 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

Path Parameters

curatorRecommendationId
string
required

The recommendation's id.

Body

application/json
decision
enum<string>
required

merge keeps A and deprecates B; deprecate_a or deprecate_b deprecates that primitive; keep_both and mark_distinct close it without changing either primitive.

Available options:
merge,
deprecate_a,
deprecate_b,
keep_both,
mark_distinct
reviewerNote
string

Recorded on the recommendation; at most 2000 characters.

Maximum string length: 2000

Response

The decided recommendation

data
object
required
meta
object
required