WA.cr APP - API v2
  1. Statuses
WA.cr APP - API v2
  • API v2 Documentation
    • Account
      • Get Account Info
      • Get Usage Statistics
      • Get Plan Limits
    • Authentication (OTP Verification)
      • Send OTP/Verification Code
      • Resend OTP
      • Verify OTP
      • Check OTP Status
      • List Authentication Templates
    • Comments
      • Get Comments
      • Add Comment
    • Contacts
      • List Contacts
      • Create Contact
      • Get Contact
      • Update Contact
      • Delete Contact
      • Batch Create Contacts
      • Batch Delete Contacts
    • Groups
      • List Groups
      • Create Group
      • Get Group
      • Update Group
      • Delete Group
      • Add Contacts to Group
      • Remove Contacts from Group
    • Messages
      • Send Text Message
      • Send Template Message
      • Send Media Message
      • Send Interactive Message
      • List Messages
      • Get Message
    • Sources
      • List Sources
      • Create Source
      • Get Source
      • Update Source
      • Delete Source
    • Statuses
      • List Statuses
        GET
      • Create Status
        POST
      • Get Status
        GET
      • Update Status
        PATCH
      • Delete Status
        DELETE
    • Templates
      • List Templates
      • Sync Templates from WhatsApp
      • Get Template
  1. Statuses

Delete Status

DELETE
/statuses/1
Permanently delete a status by ID. Cannot delete if the status is currently assigned to any contacts.

Authentication#

Required Scope: statuses:write

Path Parameters#

ParameterTypeDescription
idintegerRequired. The status ID to delete

Conflict Protection#

Before deletion, the API checks if any contacts are using this status (status_id). If contacts are found, a RESOURCE_CONFLICT error is returned with the count of affected contacts.

Response#

Success (200 OK): Returns a success confirmation with message: "Status deleted successfully". The data field is null.

Error Responses#

StatusCodeDescription
404NOT_FOUNDStatus not found
409RESOURCE_CONFLICTCannot delete status. It is being used by N contact(s)
500INTERNAL_ERRORFailed to delete status

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or

Responses

🟢200
application/json
Successful response
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE '/statuses/1' \
--header 'Authorization: Bearer <token>'
Response Response Example
{}
Modified at 2026-02-25 01:06:20
Previous
Update Status
Next
List Templates
Built with