Skip to main content

Request Review (Admin)

Run Stage-1 lint then one content-bound AI review on a partner workflow submission. The AI-review verdict is bound to a server-computed content hash: an unchanged resubmission reuses the verdict (no second review), an edit forces a fresh one. A passing verdict parks the submission in in_review for manual approval; a non-passing verdict returns status="rejected" with actionable per-issue feedback (code, message, fixHint). Stage-1 fail or skill submissions return status="rejected". Admin-scoped API key required.

Parameters

NameTypeDefaultDescription
submissionId Requiredstring-

Use Cases

  • Submit a workflow draft to the review gate — runs Stage-1 lint then one content-bound AI review
  • Re-submit unchanged content — the bound verdict is reused (no second paid review)
  • Get actionable per-issue feedback (code, message, fixHint) when a review verdict is non-passing

Example Usage

Request review for a draft

{
"tool": "admin_request_review",
"arguments": {
"submissionId": "3f7c2b1a-9d4e-4c2a-8b1f-0a1b2c3d4e5f"
}
}

Response Format

FieldTypeDescription
statusstringGate outcome. A passing verdict parks the submission in in_review for manual approval; approved is reserved for the future automated reviewer.
gateobjectPer-stage gate result.
gate.stage1object
gate.stage1.statusstring
gate.stage1.issuesarray
gate.sandboxobject
gate.sandbox.statusstring
gate.sandbox.runIdstring
gate.sandbox.durationMsnumber
gate.aiReviewobject
gate.aiReview.statusstring
gate.aiReview.verdictstring
gate.aiReview.runIdstring
gate.aiReview.summarystring
gate.aiReview.findingsarray
gate.aiReview.advisoryModeboolean
publishedBlueprintIdstringReserved — set only when a future automated path publishes on approval.
rejectionReasonstringHuman-readable reason, always present on a rejected outcome.