Remove Canned Response

Remove a canned response.

HTTP MethodURLRequires Auth

DELETE

/api/v1/canned-responses

Permission required: remove-canned-responses

Body Parameters

KeyExample ValueDescription

_id*

EwmbZ9nLSx7kFamYB

The canned response's ID.

Example Call

curl --location --request DELETE 'http://localhost:3000/api/v1/canned-responses' \
--header 'X-User-Id: 2tTEqR7ZNMJ4HGGNa' \
--header 'X-Auth-Token: A6PF2Qa-wXunBXi3j77OBY-T-gl1BvJ11jYiSMt6Z_G' \
--data '{
            "_id": "64700874a8c3a3ba32d0fb1c"
}'

Example Response

Success

{
  "success": true
}

Error

Any of the following errors can occur on the endpoint.

  • Authorization: Requires an authentication token for the request to be made.

  • No Permission: Occurs when the authenticated user doesn't have the logout-device-management permission.

  • Canned Response not found: Occurs when the _id of the canned response does not exist.

{
    "status": "error",
    "message": "You must be logged in to do this."
}

Change Log

VersionDescription

1.0.0

Added

Last updated

Rocket.Chat versions receive support for six months after release.