Legacy multipart upload

What to send

This endpoint remains available for existing integrations. For new integrations, use the standard upload flow for every file.

filefileRequired: One PDF or Word (.docx) file up to 4 MiB, sent as multipart/form-data. The standard flow accepts up to 20 MiB.
purposestring · optional: Free-form review context. Include labels such as Title:, Description:, Learning goals:, Audience:, Standards: or any other relevant information. Steletta reads all supplied context; there is no fixed list of labels or required format. Leave it out or blank to review the material as provided. Maximum 5,000 characters.
gradestringOptional: Optional grade or age group, for example Grade 6. Maximum 50 characters.
retainReportboolean · default trueOptional: Keep the report under your organization's retention policy. Set false for a temporary result available for 24 hours after completion.

Title and description are not separate request fields. Put them inside purpose, along with any other context you want considered.

For Word documents with embedded images, export to PDF so those images can be reviewed too. Older .doc files are not supported.

What you get back

A review ID and an initial status, usually queued. This is not the finished report. Use that ID to check status and get results.

Idempotency-Key is optional. Reuse it when retrying the same submission to avoid duplicate reviews. See safe retries.

Existing integration example

curl --fail-with-body "https://www.steletta.com/api/v1/reviews" \
  -H "Authorization: Bearer $STELETTA_API_KEY" \
  -F "file=@YOUR_FILE.pdf"

Example response

{
  "id": "rev_example",
  "status": "queued",
  "createdAt": "2026-09-29T14:00:00Z",
  "completedAt": null,
  "usage": {
    "estimatedUnitsMilli": 1000,
    "finalUnitsMilli": null
  },
  "error": null
}