Skip to main content
POST
Resolve a primitive admission
Decides one pending primitive admission, as the Console’s admissions page does. decision is one of:
  • admit: promotes the proposed primitive to provisional, by the same path as accepting a synthesis request.
  • reject: deprecates the proposed primitive. It is not deleted; its author may revise and resubmit.
  • send_back: records note and leaves the primitive as it is, so its author can iterate.
note, at most 2,000 characters, is recorded on the admission as its resolution note. The answer is 200 with {admissionId, admissionState, primitiveChanged, reason?}. primitiveChanged says whether the primitive actually moved; when it did not, reason says why (for example, the primitive is already at a terminal tier). If the primitive cannot be read or its lifecycle write fails, nothing is written, the admission stays pending and the answer is 500; a primitive that no longer exists resolves the admission with primitiveChanged: false. An admission that is already resolved is 409 invalid_state “Admission already resolved (<state>)”, and nothing is written. The body is strict: an unknown field or decision is 400. An empty, malformed or unknown id answers 404 resource_missing “Admission not found”. Needs synthesis:approve at the platform scope: a grant that covers only some org units receives 403, and nothing is written. A Personal key acts as its owner, through the admission’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 acted), and closes the admission’s open human task. A Forge agent can never hold synthesis:approve. Without a key, a repeat is 409: the admission 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 admission with Get judge admission; 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

admissionId
string
required

The admission's id, from listAdmissions.

Body

application/json
decision
enum<string>
required

admit promotes the proposed primitive to provisional, reject deprecates it, send_back leaves it as it is.

Available options:
admit,
reject,
send_back
note
string

Recorded on the admission as its resolution note; at most 2000 characters.

Maximum string length: 2000

Response

The resolved admission

data
object
required
meta
object
required