Skip to main content
POST
Re-judge a procedure
Schedules the procedure-correctness judge on one procedure version, named as Get procedure takes it: procedureId and an optional version. Without version, the version that route returns: the highest active version, else the highest. The answer is 200 with {scheduled, skippedReason?, subjectKind: "procedure", subjectId}, where subjectId is that version’s id. A deprecated or archived version (status_deprecated, status_archived), a built-in procedure (builtin_source) and a version with no recorded synthesis test run (no_run_evidence) are skipped: scheduled: false with skippedReason, and nothing is scheduled. Judging a version without run evidence could only fail it. Read the verdict back through Get latest judge verdict, List subject judge verdicts or Get subject judge activity with the returned subjectKind and subjectId. The body is strict: an unknown field or an empty version is 400. A procedureId or version that names no procedure version answers 404 resource_missing “Procedure not found”. Needs procedures: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; an External App or platform key is recorded as itself, with who gave its grant (see Who acted). A Forge agent can never hold procedures:approve. The credential’s scopes must also reach procedures:approve. Without a key, a repeat schedules the judge again. 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 procedures: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 subject with Get subject judge activity; 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
procedureId
string
required

The procedure's procedureId, as GET /api/v2/procedures/get takes it.

version
string

One version. Default: the version GET /api/v2/procedures/get returns.

Minimum string length: 1

Response

Whether a judge was scheduled, and the subject to read its verdict on

data
object
required
meta
object
required