Minerva API
API referenceDocuments

Process (parse) uploaded documents

POST/documents/process

Explicitly start preprocessing for a batch of already-uploaded documents (max 50 per call). Each id is resolved under the key’s org; an unknown/cross-org id returns status "not_found". A document already "processed" is skipped unless force=true; one already "processing" is never re-fired. Responds 202 with a per-document status plus a single batch jobId (a "preprocess" job) covering every queued/skipped document. Learn when parsing completes by polling GET /jobs/{jobId} for aggregate progress, or per document via the document.processed / document.processing_failed webhooks (each of which carries its own single-document jobId).

Requires an API key with one of these roles: admin, editor.

Authorization

bearerAuth
AuthorizationBearer <token>

An API key created in Settings → API Keys.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/documents/process" \  -H "Content-Type: application/json" \  -d '{    "documentIds": [      "2c049485-836c-4789-bec1-8a3d53fe6852"    ]  }'
{  "data": {    "documents": [      {        "documentId": "4704590c-004e-410d-adf7-acb7ca0a7052",        "status": "processing"      }    ],    "jobId": "string"  },  "meta": {    "requestId": "string",    "timestamp": "string"  }}