> ## Documentation Index
> Fetch the complete documentation index at: https://developers.trynawa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> NAWA API platform updates and releases

<Update label="April 16, 2026" description="/report refresh" tags={["API", "Intelligence"]}>
  ## `/report` structure and tagging update

  ### Changed

  * `/report` endpoint response structure updated. Sections now use plain-English keys (`tldr`, `headline_finding`, `comment_types`) instead of Roman-numeral keys.
  * Every percentage in report tables is now tagged `COUNT`, `ESTIMATE`, or `UNVERIFIED`.
  * Pro tier reports now open with a TL;DR section.

  ### Fixed

  * OpenAPI spec envelope schema corrected to match actual handler response.
</Update>

<Update label="April 8, 2026" description="v1.2.0" tags={["API", "New Endpoint", "English"]}>
  ## Intelligence Report API + English support

  The biggest update since launch. Two major additions:

  ### New endpoint: `POST /v1/report`

  Generate structured audience intelligence reports from comment data. Feed in comments, get back clusters, narratives, sentiment analysis, spam detection, and strategic recommendations.

  * **Basic tier** (\$0.50) - 8 sections: executive summary, clusters, narratives, sentiment, top commenters, spam detection, recommendations, channel health
  * **Pro tier** (\$1.50) - 10 sections: everything in Basic plus repeat commenter analysis with superfan detection and a content brief with episode concepts
  * Returns both markdown and pre-parsed JSON sections
  * Min 10 comments, max 500 per report
  * [Full documentation](/api-reference/report)

  ### English comment support

  All classification and reply endpoints now support English comments alongside Arabic. Language is auto-detected. English routes to Claude, Arabic routes to ALLaM. Same pricing, same API shape. `dialect` and `dialect_confidence` return `null` for English text.

  * [English classification guide](/guides/english-comment-classification)
  * Updated: [classify](/api-reference/classify), [comments-reply](/api-reference/comments-reply)
</Update>

<Update label="March 18, 2026" description="v1.1.1" tags={["API", "Reliability"]}>
  ## Claude fallback for Translate and Moderate

  Automatic Claude Haiku 4.5 fallback added to `/v1/translate` and `/v1/moderate`. If ALLaM is unavailable, requests seamlessly fall back to Claude with no user action required.

  * **`/v1/translate`** -- falls back to Claude for translation when ALLaM is down
  * **`/v1/moderate`** -- falls back to Claude for moderation when ALLaM is down
  * **`fallback_used`** -- new boolean field in all endpoint responses indicating whether the fallback provider was used
  * **`X-NAWA-Provider`** -- response header now reflects the active provider (`allam` or `claude`)
</Update>

<Update label="March 18, 2026" description="v1.1.0" tags={["API", "New Endpoint"]}>
  ## New endpoints: Translate, Detect, and Moderate

  Three new endpoints expanding NAWA from comment classification to a full Arabic language intelligence platform.

  * **`POST /v1/translate`** -- dialect-aware Arabic-English translation with tone control. Supports Gulf, Egyptian, Levantine, and MSA. 5 credits per request (\$0.005).
  * **`POST /v1/detect`** -- lightweight language and dialect detection using local NAGL modules only. Returns in under 100ms with no AI model call. 2 credits per request (\$0.002).
  * **`POST /v1/moderate`** -- dialect-aware Arabic content moderation. 7 categories (profanity, hate speech, harassment, sexual, spam, self-harm, violence) with severity scores, flagged terms, and cleaned text. 4 credits per request (\$0.004).
</Update>

<Update label="March 16, 2026" description="v1.0.0" tags={["API", "Platform"]}>
  ## NAWA API Platform v1.0 -- Live

  Self-serve API platform for Arabic comment classification, powered by HUMAIN's ALLaM 13B.

  * **8 API endpoints** live at api.trynawa.com/v1 -- classify, rubric, reply, feedback, comments, analytics, health, usage
  * **Developer console** at trynawa.com/developers/keys with Google OAuth and magic link authentication
  * **Credit-based billing** via Stripe with $25, $50, $100, and $500 packs. 1,000 credits = \$1.00.
  * **Free tier** -- 100 lifetime requests, 14-day key expiry, no credit card required. Same AI models as paid.
  * **TypeScript SDK** (@nawalabs/sdk) and **Python SDK** (nawa-sdk)
  * **Interactive docs** at developers.trynawa.com with OpenAPI 3.1 spec
  * **Semantic cache** -- identical or similar requests served free from cache
  * **RLHF calibration loop** -- pattern applicator and calibration endpoints for continuous accuracy improvement
</Update>