ReviewBlock

Fields

Human-review status of an AI report.

4 fields

message · required: string
review_id: string or null
reviewed_at: string or null
state · required: string
Pending_review: a draft until a human accepts it (also used when no review was ever recorded). not_applicable: the content was not AI-generated.

Raw schema (JSON)

{
  "description": "Human-review status of an AI report (architecture section 8.2, E8.3).\n\nCarries WHETHER and WHEN a report was reviewed, never WHO: reviewer identity\nstays in-app, out of API and export payloads.",
  "properties": {
    "message": {
      "title": "Message",
      "type": "string"
    },
    "review_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Review Id"
    },
    "reviewed_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reviewed At"
    },
    "state": {
      "description": "pending_review: a draft until a human accepts it (also used when no review was ever recorded). not_applicable: the content was not AI-generated.",
      "enum": [
        "pending_review",
        "accepted",
        "rejected",
        "superseded",
        "not_applicable"
      ],
      "title": "State",
      "type": "string"
    }
  },
  "required": [
    "state",
    "message"
  ],
  "title": "ReviewBlock",
  "type": "object"
}

Used by endpoints

7 endpoints send or return this schema, on its own or inside another schema.

POST /api/v1/agents/{agent_id}/invoke — Invoke Agent
GET /api/v1/agents/invocations/{invocation_id} — Get Invocation
POST /api/v1/agents/invocations/{invocation_id}/cancel — Cancel Invocation
POST /api/v1/agents/invocations/{invocation_id}/retry — Retry Invocation
GET /api/v1/agents/runs/{run_id}/summary — Get Run Summary
GET /api/v1/release-readiness/{run_id} — Get Release Decision
POST /api/v1/release-readiness/{run_id}/override — Override Release Decision

Used by schemas

More details

Specification: OpenAPI JSON