Delete Chatbot Profile Picture

Delete Chatbot Profile Picture

This endpoint allows you to remove the profile picture from a chatbot. After deletion, the chatbot will use the default profile picture or name initials in the chat header.

Endpoint

DELETE https://api.nexvio.ai/v1/chatbots/{chatbotId}/profile-picture

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 Profile Picture Error

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

Default Behavior

When you delete a chatbot’s profile picture:

1. Any custom profile picture previously uploaded for this chatbot will be permanently removed
2. The chatbot’s header in the chat window will revert to showing either:
   • The default profile picture provided by Nexvio.ai, or
   • The chatbot’s name initials in a colored circle
3. The change will take effect immediately for all users

Code Examples

cURL

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

JavaScript

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

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

if (data.status === 'success') {
  console.log('Chatbot profile picture 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}/profile-picture"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

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

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

UI Considerations

Removing a profile picture may affect the following aspects of your chatbot’s appearance:

1. The chatbot’s visual identity in the chat window header will change
2. If your chatbot is integrated with messaging platforms, the avatar used might revert to a default
3. Users who are familiar with your chatbot’s previous appearance might notice the change

Use Cases

Common reasons to delete a chatbot’s profile picture:

1. Rebranding your chatbot with a new visual identity
2. Temporarily removing an outdated image while preparing a replacement
3. Standardizing the appearance of multiple chatbots
4. Troubleshooting issues with the profile picture display