Back to documentation
Application API

Writing Assist API

Stable authenticated contracts for Fortifiers proofreading and schema-aware operational intake.

Base path

/api/writing-assist

Authentication

Fortifiers bearer session

Tenant scope

Active workspace required

Not a public API-key endpoint

These routes support authenticated Fortifiers application experiences. External developer API keys do not currently authorize them. Do not embed a user session token in third-party software.

Writing Assist authenticated request, protected first-party engine and reviewable response flow
POST/api/writing-assist/proofread

Proofread prose

Use for notes, descriptions, messages, comments and line-item descriptions. Maximum text length is 12,000 characters. Protected field kinds return skipped: true without modification.

Request
POST https://api.fortifiers.app/api/writing-assist/proofread
Authorization: Bearer <Fortifiers session token>
Content-Type: application/json

{
  "text": "i need the the bathrom fixed,please call me",
  "field_kind": "notes",
  "locale": "en-CA"
}
Response
{
  "original_text": "i need the the bathrom fixed,please call me",
  "suggested_text": "I need the bathroom fixed, please call me",
  "suggestions": [
    {
      "category": "spelling",
      "before": "bathrom",
      "after": "bathroom",
      "confidence": 0.97,
      "rule_id": "common-typo"
    }
  ],
  "needs_review": true,
  "skipped": false,
  "version": "fortifiers-autofill-proofreader-0.1"
}
POST/api/writing-assist/correct

Correct structured intake

Profiles are lead, quote, job and payment. The response contains candidate fields, changes, missing required fields, confirmation questions, confidence and readiness. Never persist the returned record automatically when ready is false.

Request
POST https://api.fortifiers.app/api/writing-assist/correct
Authorization: Bearer <Fortifiers session token>
Content-Type: application/json

{
  "profile": "lead",
  "input": "plumbr need bathrom leak at 12 Queen Street, Charlottetown budget $500"
}

Client integration rules

  • • Debounce while typing and cancel stale requests.
  • • Keep the manual form usable during timeouts, 401s, 429s and service errors.
  • • Never silently overwrite or save a suggestion.
  • • Preserve the original value for undo.
  • • Do not call proofreading for credentials, contact values, money, dates, choices, IDs, searches or URLs.