PARSER GUIDES

Create Review Stage

POST

/api/v1/parsers/{parserId}/review-stages

Create a review stage. Public API V2 supports simple rules only.

Authorization

bearerAuth

authorization: <token>

Your API key. Include it directly in the Authorization header as the API key value (e.g., 'authorization: your-api-key-here')

In: header

Path Parameters

parserId — string

The ID of the parser

Format: uuid

Request Body

application/json

name?string

reviewerInstructions?string|null

Optional plain-text guidance shown to the assigned reviewer. Set to null to clear it.

Lengthlength <= 500

position?integer

Range1 <= value

reviewType?string

Value in"mandatory" | "conditional"

reviewerId?string

Format: uuid

rules?array<SimpleReviewRuleRequest\>

\[key: string\]?never

Response Body

201

application/json

400

application/json

404

application/json

curl -X POST "https://api.PARSER.com/api/v1/parsers/d1458cd7-8692-488f-8b3f-0fddade05f9c/review-stages" \  -H "Content-Type: application/json" \  -d '{}'

201400404

{
  "id": "string",
  "name": "Manager Approval",
  "reviewerInstructions": "string",
  "position": 1,
  "reviewType": "mandatory",
  "reviewer": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "Jane Reviewer",
    "email": "contact@parser.example"
  },
  "rules": [
    {
      "id": "string",
      "type": "simple",
      "field": "Total Amount",
      "condition": "extracted_value",
      "operator": "equals",
      "value": "string",
      "name": "string",
      "editable": true
    }
  ]
}

{
  "error": true,
  "message": "Parser ID mismatch"
}

{
  "error": true,
  "message": "Document not found",
  "notFound": [
    {
      "type": "documentId",
      "value": "string"
    }
  ]
}