Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(api): note that a text status must not be blank

Yudhi Armyndharisfd8efe06f937
diff --git a/docs/06-api-specification.md b/docs/06-api-specification.md
index 661c455dc..e289eee5c 100644
--- a/docs/06-api-specification.md
+++ b/docs/06-api-specification.md
@@ -4304,7 +4304,7 @@ Post a text status (story) to the session's status feed. The recipients allow-li
| Field | Type | Required | Constraints | Description |
| --------------- | -------- | -------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| text | string | yes | `@MaxLength(4096)` | Status text body |
+| text | string | yes | not blank (`@Matches(/\S/)`), `@MaxLength(4096)` | Status text body |
| recipients | string[] | no | 0–256 items, each matching `^\d+@(c\.us\|lid)$` | JIDs of the contacts permitted to view the status. **Honored on Baileys only** (passed as `statusJidList`), where it is required in practice — Baileys posts to exactly this allow-list, so omitting it reaches nobody. whatsapp-web.js ignores it and broadcasts to the account's status-privacy audience; omit it there |
| backgroundColor | string | no | 6-digit hex color matching `^#[0-9A-Fa-f]{6}$` | e.g. `#25D366`; bad value → `backgroundColor must be a hex color (e.g., #25D366)` |
| font | integer | no | `@IsIn([0, 1, 2, 6, 7, 8, 9, 10])` — `3`–`5` are rejected with `400` | WhatsApp status font index: `0` (default), `1`, `2`, `6` (bold), `7`, `8`, `9`, `10`. whatsapp-web.js honors only `0`–`7` and clamps anything above back to the default |