Delete Chatbot Icon

This endpoint allows you to remove the icon image from a chatbot. After deletion, the chatbot will use the default icon.

Endpoint

DELETE https://api.nexvio.ai/v1/chatbots/{chatbotId}/icon

Headers

Name	Required	Description
`Authorization`	Yes	Your API key in the format: `Bearer YOUR_API_KEY`

Path Parameters

Parameter	Type	Required	Description
`chatbotId`	string	Yes	The ID of the chatbot

Response

{
  "status": "success",
  "data": {
    "deleted": true,
    "chatbot_id": "chatbot_456def"
  }
}

Error Responses

Authentication Error

{
  "status": "error",
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Not Found Error

{
  "status": "error",
  "error": {
    "code": "not_found",
    "message": "Chatbot not found"
  }
}

No Icon Error

{
  "status": "error",
  "error": {
    "code": "not_found",
    "message": "This chatbot does not have a custom icon"
  }
}

Default Behavior

When you delete a chatbot’s custom icon:

Any custom icon previously uploaded for this chatbot will be permanently removed
The chatbot’s chat bubble will revert to using the default icon provided by Nexvio.ai
The change will take effect immediately for all users

Code Examples

cURL

curl -X DELETE "https://api.nexvio.ai/v1/chatbots/chatbot_456def/icon" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const chatbotId = 'chatbot_456def';
const response = await fetch(`https://api.nexvio.ai/v1/chatbots/${chatbotId}/icon`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

if (data.status === 'success') {
  console.log('Chatbot icon has been successfully deleted.');
  // Update your UI if needed
}

Python

import requests

chatbot_id = "chatbot_456def"
url = f"https://api.nexvio.ai/v1/chatbots/{chatbot_id}/icon"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.delete(url, headers=headers)
data = response.json()
print(data)

if data["status"] == "success":
    print("Chatbot icon has been successfully deleted.")
    # Update your application state if needed

Use Cases

Some common reasons to delete a chatbot icon:

Replacing an outdated brand image with the default while preparing a new design
Maintaining visual consistency across multiple chatbots by using the standard icon
Removing a custom icon that doesn’t display well on certain backgrounds
Troubleshooting display issues by reverting to the default icon