Skip to main content
POST
Assign a reviewer to synthesis requests
Sets reviewerSubject as the reviewer of each request, in any status, or clears the assignment when reviewerSubject is null, as the Console’s assign does. The subject must be an active person; otherwise the call answers 400 “reviewerSubject is not an active person” and nothing is written. Only an id this deployment cannot find is skipped, as not_found. One audit event records the call. Read the assignment back as reviewerAssignedTo and reviewerAssignedAt on the request. 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; an External App or platform key is recorded as itself, with who gave its grant (see Who decided). The response never names who decided. Without a key, a repeat is not a no-op: it applies the same assignment again, re-stamps the assignment time and writes another audit event. 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
reviewerSubject
string | null
required

The reviewer's subject (an active person), or null to clear the assignment.

Response

One outcome per id

data
object
required
meta
object
required