Validate Submission (Admin)

Re-run Stage-1 lint on a persisted partner submission and optionally trigger Stage-2 AI review. Returns {status, issues[], aiReview?} per spec §6.3. Requires an admin-scoped API key. Submissions belonging to other orgs return submission_not_found.

Parameters

Name	Type	Default	Description
submissionId Required	string	-
includeAiReview	boolean	false

Use Cases

• Re-run Stage-1 lint on a persisted submission and get the issue list
• Trigger a Stage-2 AI review and read its verdict (set includeAiReview=true)
• Poll for an in-flight AI-review verdict (default call echoes cached state)

Example Usage

Stage-1 lint only

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

Also run Stage-2 AI review

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

Response Format

Field	Type	Description
status	string	Overall Stage-1 lint verdict.
issues	array
issues[].code	string	Stable issue code (ISSUE_CODES).
issues[].severity	string
issues[].field	string
issues[].message	string
issues[].fixHint	string	Actionable remediation hint.
aiReview	object	Present only when a Stage-2 review was requested or a cached verdict exists.
aiReview.status	string
aiReview.runId	string
aiReview.verdict	string
aiReview.findings	array
aiReview.findings[].code	string
aiReview.findings[].severity	string
aiReview.findings[].field	string
aiReview.findings[].message	string
aiReview.findings[].evidence	string
aiReview.findings[].fixHint	string
aiReview.summary	string
aiReview.modelVersion	string
aiReview.advisoryMode	boolean	Present when auto-publish is suppressed pending human review.