Links

Delete Livechat Transcript

This endpoint is used to cancel any transcript requests for an open room, meaning that the chat transcript won't be sent after the chat is closed. You can not Send Livechat Transcript twice at a time. You must delete the previous request with this endpoint before requesting again.
  • It requires the send-omnichannel-chat-transcript permission.
HTTP Method
URL
Requires Auth
DELETE
/api/v1/livechat/transcript/:rid
yes

Path Variables

Key
Example Value
Description
rid*
tcbbSmWSLR5uo5PBW
The room ID.

Example Call

curl -L -X DELETE 'http://localhost:3000/api/v1/livechat/transcript/WrosEi8fKFedLbQMe' \
-H 'x-auth-token: 6gwMfYPDoQzMCAnwjP5iILveZINplU7V-1DYzkhhxsc' \
-H 'x-user-id: rmbMnnpqkuxEbrajt'

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 send-omnichannel-chat-transcript permission.
  • Transcript Not Requested: Occurs when there is no existing transcript request.
Authorization
No Permission
Transcript Not Requested
{
"status": "error",
"message": "You must be logged in to do this."
}
{
"success": false,
"error": "User does not have the permissions required for this action [error-unauthorized]"
}
{
"success": false,
"error": "error-transcript-not-requested"
}

Change Log

Version
Description
6.4.0
Added
Last modified 5d ago
Deprecation for cloud services and apps is now extended to November 20, 2023. Rocket.Chat versions receive support for six months after release.