> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stealthgpt.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Changelog
> Track important updates and changes to the StealthGPT API.
## Humanize PDF & DOCX Files
`POST /api/stealthify/runs` now accepts file uploads. Send a document as `multipart/form-data` and the text is extracted server-side, then humanized like a regular text run — the result is returned as plain text in the usual `result` field.
### What's New
* **File upload on the async endpoint**: send `multipart/form-data` with a `file` field instead of a JSON `text` body
* **Supported types**: `.pdf`, `.docx`, `.txt`, `.md` (max 4MB; scanned or image-only documents are not supported)
* **Same options**: `qualityMode`, `model`, `outputFormat`, `webhookUrl`, and `webhookSecret` can be passed as form fields
* **Same billing**: input words extracted from the file plus output words, at 1 credit per word
### Compatibility
JSON requests to `POST /api/stealthify/runs` are unchanged. The legacy `POST /api/stealthify` endpoint is unaffected.
### Where to Start
* [File upload reference](/api-reference/endpoints/stealthify-runs#request-body-file-upload)
* [Async Writer & Humanizer reference](/api-reference/endpoints/stealthify-runs)
## Zapier Integration (Live)
The StealthGPT [Zapier integration](/api-reference/integrations/zapier) is now live. Connect StealthGPT to 8,000+ apps and generate or humanize content inside your Zaps — no code required.
### What's New
* **Live on Zapier**: add StealthGPT from **App Connections → Create connection**
* **Bring your own API token** from your [Stealth API dashboard](https://stealthgpt.ai/stealthapi/dashboard)
* Actions for **Generate Long-Form Content**, **Humanize Text**, and **Get Run Status** — built on the async API
### Where to Start
* [StealthGPT for Zapier](/api-reference/integrations/zapier)
## WordPress Plugin (Live)
The official [StealthGPT WordPress plugin](https://wordpress.org/plugins/stealthgpt/) is now available on the WordPress.org directory. Generate long-form content or humanize existing text directly in WordPress — the result lands in a draft post for review before publishing.
### What's New
* **Live on WordPress.org**: install from **Plugins → Add New → search "StealthGPT"**
* **Bring your own API key**; full generation and humanization, both written to drafts
* Async by design — runs complete via webhook with background polling fallback
### Where to Start
* [StealthGPT for WordPress](/api-reference/integrations/wordpress)
## More Integrations: Zapier & WordPress (in review)
Two more integrations are built and currently in review on their respective marketplaces:
* **Zapier app** — Generate Long-Form Content, Humanize Text, and Get Run Status across 7,000+ apps. In review by Zapier.
* **WordPress plugin** — generate or humanize content into draft posts, BYO API key. In review for the WordPress.org directory.
Until they're live, automate StealthGPT via the [n8n node](/api-reference/integrations/n8n), [MCP clients](/api-reference/integrations/mcp), or the [async REST API](/api-reference/endpoints/stealthify-agent-runs).
### Where to Start
* [Zapier (coming soon)](/api-reference/integrations/zapier)
* [WordPress (coming soon)](/api-reference/integrations/wordpress)
## n8n Node (Verified)
StealthGPT is now an official, **n8n-verified** node, [`n8n-nodes-stealthgpt`](https://www.npmjs.com/package/n8n-nodes-stealthgpt) — listed on the [n8n integrations directory](https://n8n.io/integrations/stealthgpt/). Start content-pipeline runs and humanize text directly inside n8n workflows, using the async API under the hood.
### What's New
* **Verified by n8n**: available on self-hosted **and n8n Cloud** (instance owner enables once)
* **Operations**: Content Generation and Text Humanization, each with **Start Run** and **Get Run Status**
* **Wait for completion**: start-and-wait (poll until terminal) or start-only for webhook/manual polling
### Where to Start
* [Automate StealthGPT with n8n](/api-reference/integrations/n8n)
## MCP Server + OAuth
StealthGPT now ships a remote **MCP (Model Context Protocol) server**, so AI agents and MCP-aware clients can generate and humanize content as a tool. Connect it in Cursor, Claude Desktop/Code, and as a one-click custom connector in **claude.ai (web)**.
### What's New
* **MCP endpoint**: `https://www.stealthgpt.ai/api/mcp/mcp` (Streamable HTTP)
* **Tools**: `generate_content`, `humanize_text`, `get_run_status`
* **Dual auth**: OAuth 2.1 (one-click sign-in for claude.ai web) or `Authorization: Bearer YOUR_API_TOKEN` (Cursor, VS Code, Claude Desktop, CLIs) — both resolve to the same account
* **Async by design**: tools return a `runId`; poll `get_run_status` until terminal
### Where to Start
* [Use Stealth Agent from MCP clients](/api-reference/integrations/mcp)
## Async Writer & Humanizer Runs
Writer & Humanizer now supports native async runs for long-running humanization. Create a run with `POST /api/stealthify/runs`, poll `GET /api/stealthify/runs/{runId}`, and optionally receive a terminal webhook callback through `webhookUrl`.
### What's New
* **New create endpoint**: `POST /api/stealthify/runs`
* **New polling endpoint**: `GET /api/stealthify/runs/{runId}`
* **Idempotent create retries**: send `idempotency-key` to avoid duplicate queued runs
* **Webhook callbacks**: receive `completed`, `failed`, or `cancelled` payloads at `webhookUrl`
### Compatibility
The existing `POST /api/stealthify` endpoint is unchanged and remains supported for current API clients.
### Where to Start
* [Async Writer & Humanizer reference](/api-reference/endpoints/stealthify-runs)
* [Writer & Humanizer endpoint](/api-reference/endpoints/stealthify)
* [Pricing](/api-reference/pricing)
## Async Stealth Agent Runs
Stealth Agent now supports native async runs for long-running integrations. Create a run with `POST /api/stealthify/agent/runs`, poll `GET /api/stealthify/agent/runs/{runId}`, and optionally receive a terminal webhook callback through `webhookUrl`.
### What's New
* **New create endpoint**: `POST /api/stealthify/agent/runs`
* **New polling endpoint**: `GET /api/stealthify/agent/runs/{runId}`
* **Idempotent create retries**: send `idempotency-key` to avoid duplicate queued runs
* **Webhook callbacks**: receive `completed`, `failed`, or `cancelled` payloads at `webhookUrl`
### Where to Start
* [Async runs reference](/api-reference/endpoints/stealthify-agent-runs)
* [Stealth Agent overview](/api-reference/stealth-agent/overview)
* [Usage guide](/api-reference/stealth-agent/guide)
## AI Detector Endpoint
A new `POST /api/stealthify/detect` endpoint exposes the same AI-detection backend that powers the [AI Detector tool](https://www.stealthgpt.ai/ai-detector) on the website. Submit text and receive a `howLikelyToBeDetected` score (0-100) using the standard Stealth API authentication and billing model.
### What's New
* **New endpoint**: `POST /api/stealthify/detect`
* **Request body**: `{ "text": string }` (max 3,000 words)
* **Response**: `howLikelyToBeDetected` (0-100), `wordsSpent`, `remainingCredits`, `billingMode`, `meteredChargedCredits`
* **Billing**: charged words = input words (1 charged word per input word)
### Where to Start
* [Endpoint reference](/api-reference/endpoints/detect)
* [Pricing](/api-reference/pricing)
## Business Mode Removed, Replaced by Stealth Agent
Business mode on `/api/stealthify` has been **removed** and replaced by the new [Stealth Agent](/api-reference/endpoints/stealthify-agent) endpoint. Stealth Agent runs a full pipeline (research → draft → optional fact-check → humanize → optional images) in a single call, producing higher-quality long-form output than the previous Business engine.
### What's Changed
* **`business` flag removed**: The 10x business engine no longer runs. The `business` field is still accepted in `/api/stealthify` request bodies for backward compatibility but has no effect — no client changes are required.
* **Billing simplified**: All `/api/stealthify` requests are billed at the standard rate (input words + output words). The 10x business multiplier no longer applies.
* **Migration path**: Workloads that previously relied on Business mode (academic, SEO long-form, professional posts) should switch to `POST /api/stealthify/agent`.
### Where to Start
* [Stealth Agent overview](/api-reference/stealth-agent/overview)
* [Usage guide](/api-reference/stealth-agent/guide)
* [Use cases](/api-reference/stealth-agent/use-cases)
* [Endpoint reference](/api-reference/endpoints/stealthify-agent)
## Business Mode Temporarily Disabled
Business mode on `/api/stealthify` is currently disabled.
### What's Changed
* **`business` flag ignored**: Requests are processed with the standard engine regardless of whether `business` is sent as `true` or `false`
* **Standard billing applied**: All `/api/stealthify` usage is billed at the standard rate (input words + output words), with no 10x Business multiplier
* **Schema unchanged**: The `business` field is still accepted in request bodies for backward compatibility; no client changes are required
See the [Writer & Humanizer endpoint](/api-reference/endpoints/stealthify), [Advanced Usage](/api-reference/advanced-usage), and [Pricing](/api-reference/pricing) pages for details.
## Stealth Agent API
Documentation is available for **`POST /api/stealthify/agent`**: multi-step Stealth Agent generation (academic, SEO, or social) with the same Stealth API authentication and billing model as `/api/stealthify`. See [Stealth Agent](/api-reference/endpoints/stealthify-agent).
## Free-to-Start API Billing
StealthGPT API billing has moved to a free-to-start pay-as-you-go model.
### What's Changed
* **Free activation flow**: New users now activate API billing by adding a payment method instead of buying a fixed starter pack
* **Usage-based invoicing**: API usage is billed automatically as pay-as-you-go
* **Tiered billing thresholds**: Invoicing thresholds now scale by tier based on spend within each billing period
* **Automatic tier advancement**: Accounts can move up to higher invoice thresholds automatically as billing-period spend increases; for higher limits or custom arrangements, email [joey@stealthgpt.ai](mailto:joey@stealthgpt.ai)
### Impact for Existing Users
* **Users with prepaid words**: Existing balances continue to be used first with no interruption
* **Legacy users**: If prompted, accept updated billing terms in the dashboard to keep uninterrupted API access
## Pay-As-You-Go Billing Enabled
StealthGPT API now supports pay-as-you-go billing after your starter/prepaid words are used.
### What's New
* **Hybrid Billing Model**: Start with free starter access after activation/payment setup (and/or prepaid words), then continue automatically on usage-based billing
* **Standard Usage Rate**: \$0.20 per 1,000 words for standard requests (`business=false`)
* **Business Usage Rate**: \$2.00 per 1,000 words for business requests (`business=true`)
* **Legacy Account Action Required**: Legacy users must accept the new terms in their billing dashboard to continue billing under the updated model
### How It Works
After your prepaid word balance reaches zero, requests continue without interruption and usage is billed automatically based on endpoint mode and word consumption.
## New Detector Optimization
You can now optimize your content for specific AI detection tools using the new `detector` parameter.
### What's New
* **Detector Parameter**: Choose between `"turnitin"` (default) or `"gptzero"` to optimize your content for different detection systems
* **Automatic Optimization**: The API automatically adjusts generation settings based on your selected detector
* **Enhanced Compatibility**: Improved performance across different AI detection platforms
### Getting Started
Simply add the `detector` parameter to your `/api/stealthify` requests to get content optimized for your preferred detection tool.
## Tokens Deprecated, Words Introduced
The StealthGPT API now uses a word-based system instead of tokens. All references to `tokens` have been replaced with `words` throughout the documentation and API responses.
### How Words Are Counted
For the [/api/stealthify](/api-reference/endpoints/stealthify) endpoint, the cost is now calculated as `input words + output words`. This means you are charged for the total number of words in your prompt plus the words in the generated or rephrased output. For shorter requests, this results in a lower cost; for longer requests, the difference is minimal, making the new system more transparent and fair.
### Deprecated Fields in [/api/stealthify](/api-reference/endpoints/stealthify)
* `tokensSpent` (use `wordsSpent` instead)
* `systemTokensSpent`
* `totalTokensSpent`
### New Field
* `wordsSpent` (number of words used for content generation or rephrasing)