Skip to main content
POST
Re-judge a workflow
Schedules the Architect judge on a workflow’s draft, named by the workflow’s workflowId. The answer is 200 with {scheduled: true, subjectKind: "workflow_graph", subjectId}, where subjectId is the draft’s draftId, as Get workflow draft returns 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 is 400. A deleted workflow, a workflow without a draft, and an empty, malformed or unknown workflowId answer 404 resource_missing “Workflow not found”. Needs workflows:manage 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 workflows:manage. 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 workflows:manage 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
workflowId
string
required

The workflow's workflowId; its draft is judged.

Response

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

data
object
required
meta
object
required