API Reference
Dashboard
  1. API Reference
  2. Box API
  3. SMS & USSD

Delete SMS messages stored on the SIM or modem of one slot

Use this to clear the inbox. Needs the SMS/USSD licence feature. Without index the modem's messages are deleted; Android phones accept index to delete one message. Deleted messages cannot be recovered. A body without position fails with HTTP 500. The Hub never relays this route.

  • Destructive · confirm first
  • Basic auth
  • Public API · since v20.8.0
  • Hub: blocked by the Hub
  • deleteSms
POST/sms/delete

Request body application/json · required

positionintegerrequired
indexintegeroptional

Message index (Android phones).

Responses

Result.

statusbooleanrequired

True when the box accepted the request.

msgstringrequired

Outcome code or message (see the operation's error table).

Errors returned in msg

msgMeaningWhat to do
need_upgradeThe licence has no SMS/USSD feature.Upgrade the plan.
Deleted failed!The modem refused the delete.Retry; check the modem.
Verified against XProxy v21.3.2 on Nov 17, 2026