Skip to main content

Delete conversation history

Use the /api/bot/history/chat/delete endpoint to delete a bot's chat history.

Endpoint Details​

  • Route: /api/bot/history/chat/delete/<bot_id>/<user_id>
  • Method: GET

Query Parameters​

  • bot_id: ID of the bot from which messages will be deleted.
  • user_id: ID of the user whos conversation history will be deleted.

Response​

{
  "message": "History deleted",
  "history": [
    {
      "historyID": "ID of the message",
      "bot": "Id of the bot",
      "text": "Text message",
      "is_bot": "True if the message is sent by bot else false",
      "is_api": "False",
      "is_voice": "true if the message was sent or received in audio format",
      "voice_path": "path to the audio file",
      "image_path": "path to the image file",
      "username": "username to whom the message belongs to",
      "user_id": "user_id to whom the message belongs",
      "created_at": "time when the message was created",
      "updated_at": "time when the message was updated",
    },
    ...
  ]
}

Example usage​

curl -X GET "https://api.botworx.io/api/bot/history/chat/delete/bc38325df27a79f0e53f46c1a151cfd7/5ere3e3f32vf342r2f" \