API Reference

[BETA] post a text or media status/story

post
https://waapi.app/api/v1/instances//client/action/post-status

Publishes a status update visible to contacts per the user's privacy settings. Provide content for a text status (with optional backgroundColor ARGB integer and fontStyle 0-7) or mediaUrl (plus optional mediaCaption) for an image/video/audio status. Note: This endpoint is currently in beta and may change without notice.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required

Instance ID

Body Params
string

Text content for a text status, or caption fallback for media

uri

Publicly reachable URL of image/video/audio for a media status

string

Caption for a media status (overrides content)

string

Optional filename for the downloaded media

integer

ARGB color for text status background (e.g. 4286070949 = 0xff7acca5)

integer
0 to 7

Font style index for text status, 0 through 7

boolean

Send the video media as a GIF

boolean

Send the audio media as a voice note

audience
object

Optional audience restriction. ⚠️ Setting this changes the persistent account-level Status privacy and is synchronized to all linked devices. To restore the default visibility, call /set-status-privacy with type "all".

Responses

data.status reports whether the action was carried out; on error data carries message and explanation. Payload: Status posted successfully.

401

Unauthorized — invalid or missing bearer token

403

Forbidden — insufficient permissions or account blocked

404

Not found — instance does not exist or does not belong to you

409

Conflict — instance is not ready

429

Too many requests — rate limit exceeded

Updated 5 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago

Did this page help you?