API Documentation
Upload Agent Icon
Upload a custom icon for your agent's chat widget button.
This endpoint accepts multipart/form-data. Do not set the Content-Type header manually — the browser or HTTP client will set it automatically with the correct boundary.
Accepted formats: PNG, JPG. Maximum file size: 1 MB.
Endpoint
POST https://www.chatzuri.com/api/v1/upload-agent-iconExample Request
const formData = new FormData();
formData.append('file', fileInput.files[0]); // PNG or JPG, max 1MB
formData.append('agentId', '<Your-Agent-ID>');
const res = await fetch('https://www.chatzuri.com/api/v1/upload-agent-icon', {
method: 'POST',
headers: {
Authorization: 'Bearer <Your-Secret-Key>'
// Do NOT set Content-Type — let the browser set it with the boundary
},
body: formData
});
const data = await res.json();
console.log(data.iconUrl);Response
{
"iconUrl": "https://cdn.chatzuri.com/icons/agent_abc123_icon.png"
}Error Handling
How to handle API errors gracefully
If there are any errors during the API request, appropriate HTTP status codes will be returned along with error messages in the response body.
That's it! You should now be able to create a agent using the create API.
Remember to implement proper error logging and user notifications in your application
400
Bad Request
401
Unauthorized
500
Server Error
