Create a review matrix

Creates a matrix with one row per document and one pending cell per column. Generation is a separate call (POST /reviews/{id}/generate). Every done cell must carry ≥1 citation or the literal not_found.

POST/reviews

Authorization

AuthorizationBearer token · headerrequired

Pass your API key as a Bearer token. API keys are scoped to specific operations — configure scopes in your organization's Settings → Developer → API Keys.

Request body

requiredapplication/json

titlestringrequired

max length 200

modelstringrequired

Provider/model key (echo/test for local stub)

max length 120

columnsReviewColumn[]required

min items 1 · max items 32

Show properties

Array of ReviewColumn

indexintegerrequired

min 0

namestringrequired

max length 120

promptstringrequired

max length 4000

documentIdsstring[]required

Document public IDs in this organization

min items 1 · max items 100

Responses

201

Created matrix (cells pending)

idstringrequired

titlestringrequired

modelstringrequired

Provider/model key, e.g. echo/test or anthropic/claude-sonnet-4-5

statusstringrequired

columnsReviewColumn[]required

Show properties

Array of ReviewColumn

indexintegerrequired

min 0

namestringrequired

max length 120

promptstringrequired

max length 4000

rowsReviewRow[]required

Show properties

Array of ReviewRow

idstringrequired

document_idstringrequired

Document public ID

cellsReviewCell[]required

Show properties

Array of ReviewCell

idstringrequired

row_idstringrequired

column_indexintegerrequired

min 0

statusReviewCellStatusrequired

Allowed:pendinggeneratingdoneerror

summarystring | nullrequired

flagobject | nullrequired

Show properties

object

reasoningstring | nullrequired

citationsReviewCitation[]required

Show properties

Array of ReviewCitation

documentIdstringrequired

pageinteger

min 1

quotestringrequired

Contiguous excerpt from the document, or the literal not_found

created_atstring<date-time>required

updated_atstring<date-time>required

400

Invalid request parameters

typestringrequired

Machine-readable error code

statusintegerrequired

HTTP status code

titlestringrequired

Human-readable error message

detailsobject

Field-level validation errors

401

Missing or invalid API key

typestringrequired

Machine-readable error code

statusintegerrequired

HTTP status code

titlestringrequired

Human-readable error message

detailsobject

Field-level validation errors

404

Resource not found

typestringrequired

Machine-readable error code

statusintegerrequired

HTTP status code

titlestringrequired

Human-readable error message

detailsobject

Field-level validation errors

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X POST "https://api.seal.nyc/api/v1/reviews" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "model": "string",
  "columns": [
    {
      "index": 0,
      "name": "string",
      "prompt": "string"
    }
  ],
  "documentIds": [
    "string"
  ]
}'

const response = await fetch("https://api.seal.nyc/api/v1/reviews", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"title\": \"string\",\n  \"model\": \"string\",\n  \"columns\": [\n    {\n      \"index\": 0,\n      \"name\": \"string\",\n      \"prompt\": \"string\"\n    }\n  ],\n  \"documentIds\": [\n    \"string\"\n  ]\n}"
});

import requests

response = requests.post(
    "https://api.seal.nyc/api/v1/reviews",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"title\": \"string\",\n  \"model\": \"string\",\n  \"columns\": [\n    {\n      \"index\": 0,\n      \"name\": \"string\",\n      \"prompt\": \"string\"\n    }\n  ],\n  \"documentIds\": [\n    \"string\"\n  ]\n}",
)

Response

{
  "id": "string",
  "title": "string",
  "model": "string",
  "status": "string",
  "columns": [
    {
      "index": 0,
      "name": "string",
      "prompt": "string"
    }
  ],
  "rows": [
    {
      "id": "string",
      "document_id": "string",
      "cells": [
        {
          "id": "string",
          "row_id": "string",
          "column_index": 0,
          "status": "pending",
          "summary": "string",
          "flag": "green",
          "reasoning": "string",
          "citations": [
            {
              "documentId": "string",
              "page": 1,
              "quote": "string"
            }
          ]
        }
      ]
    }
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

{
  "type": "VALIDATION_ERROR",
  "status": 400,
  "title": "Validation failed",
  "details": {
    "email": [
      "Must be a valid email address"
    ]
  }
}

{
  "type": "AUTH_ERROR",
  "status": 401,
  "title": "Missing or invalid API key"
}

{
  "type": "NOT_FOUND",
  "status": 404,
  "title": "Document not found"
}