Skip to main content
POST
/
api
/
{session}
/
status
/
delete
{
  "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E",
  "sender": "[email protected]",
  "participants": [
    "[email protected]",
    "[email protected]"
  ]
}

{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

​
Description

This endpoint allows you to delete a status (story) that was previously sent on WhatsApp. You can delete the status for all contacts or only for specific contacts.

​
URL Parameters

​
session
string
required
Unique authenticated session ID

​
Request Body

​
messageId
string
required
Message ID of the status to be deleted
​
sender
string
required
Sender JID (your account) in the format [email protected]
​
participants
array
Array of contact JIDs for whom the status will be deleted. If not specified, the status will be deleted for all contacts.JID format: ["[email protected]"]
{
  "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E",
  "sender": "[email protected]",
  "participants": [
    "[email protected]",
    "[email protected]"
  ]
}

​
Response

​
success
boolean
required
Indicates if the status was deleted successfully
​
messageId
string
Message ID of the status that was deleted
{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

​
Status Codes

  • 200 - Status deleted successfully
  • 400 - Invalid parameters
  • 401 - Unauthorized
  • 404 - Status not found
  • 500 - Server error

​
Usage Example

curl -X POST https://api.wappfy.com.br/api/my-session/status/delete \
  -H "Content-Type: application/json" \
  -d '{
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E",
    "sender": "[email protected]"
  }'

​
Notes

  • Status are temporary content (Stories) that disappear after 24 hours
  • You can only delete status that were sent by your account
  • If the participants parameter is not specified, the status will be deleted for all contacts
  • The sender field must contain the JID of your own account in the format [email protected]
  • Once deleted, the status cannot be recovered
  • The messageId can be obtained from the response of the status send endpoint

Authorizations

​
apikey
string
header
required

Your Wappfy API key (get it at dash.wappfy.com.br)

Path Parameters

​
session
string
required

Session name (instanceName)

Body

application/json
​
id
string

Status message id to delete

Example:

"AAAAAAAAAAAAAAAAA"

​
contacts
string[]

Contact list to send the status to.

Example:

null

Response

201 - undefined