Post an image status
POST/api/sessions/:sessionId/status/send-image
Post an image status
Request
Responses
- 201
- 400
- 404
- 409
- 413
Image status posted. The recipients allow-list is honored on Baileys only; whatsapp-web.js broadcasts to the account's status-privacy audience.
Neither url nor base64 provided, or the post was blocked by a plugin.
No session is running under that id — it was never started, was stopped, or does not exist. These routes report an unstarted session as 404, where the message and group routes report it as 400.
The session is not connected — an engine exists for it but is not ready: disconnected, reconnecting, or still initializing, so the request never reached WhatsApp. Wait for ready and retry. A session that was never started answers 400 instead, and the session lifecycle routes answer 409 for a conflicting state rather than this. One window answers this while the session still reads ready: WhatsApp Web periodically reloads its own page and the engine re-injects into it — for those few seconds the answer is a 409 naming the reload; retry shortly.
Base64 media exceeds MEDIA_DOWNLOAD_MAX_BYTES.