Skip to main content
Enable or disable disappearing messages for a chat conversation. When enabled, messages will automatically delete after the specified time period.
Valid timer values are:
  • 0 - Off (disable disappearing messages)
  • 86400 - 24 hours
  • 604800 - 7 days
  • 7776000 - 90 days
Any other value will result in an error.

Request

chat_jid
string
required
Chat JID identifier:Example: [email protected]
X-Device-Id
string
Device identifier for multi-device support. Required when multiple devices are registered. If only one device is registered, it will be used as the default.
timer_seconds
integer
required
Timer duration in seconds:
  • 0: Off (disable disappearing messages)
  • 86400: 24 hours
  • 604800: 7 days
  • 7776000: 90 days
Example: 86400

Response

status
integer
HTTP status code (e.g., 200)
code
string
Response code (e.g., SUCCESS)
message
string
Response message describing the resultExample: Disappearing messages set to 86400 seconds
results
object
status
string
Status of the operationExample: success
message
string
Detailed status message
chat_jid
string
The JID of the affected chat
timer_seconds
integer
The configured timer value in seconds
curl -X POST \
  'https://your-api-domain.com/chat/[email protected]/disappearing' \
  -H 'Content-Type: application/json' \
  -H 'X-Device-Id: my-device' \
  -u 'username:password' \
  -d '{
    "timer_seconds": 86400
  }'
{
  "status": 200,
  "code": "SUCCESS",
  "message": "Disappearing messages set to 86400 seconds",
  "results": {
    "status": "success",
    "message": "Disappearing messages set to 86400 seconds",
    "chat_jid": "[email protected]",
    "timer_seconds": 86400
  }
}

Build docs developers (and LLMs) love