sitegpt-ai Chatbot Icons API
APIs to manage (add/update/delete) icons related to a particular chatbot.
APIs to manage (add/update/delete) icons related to a particular chatbot.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sitegpt-ai:sitegpt-ai-chatbot-icons-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SiteGPT API Collection Chatbot Icons API
description: 'This collection contains the documentation of all the API endpoints.
## Getting started guide
To start using the SiteGPT APIs, you need to
- You must use a valid API Key to send requests to the API endpoints. You can get your API key from SiteGPT''s billing dashboard. If you don''t see it there, contact admin to generate one for you.
- The API returns request responses in JSON format. When an API request returns an error, it is sent in the JSON response as an error key.
## Authentication
SiteGPT uses API keys for authentication. You can generate a SiteGPT API key in the billing dashboard.
You must include an API key in each request to the Postman API with the Authorization request header.
Header Name : Authorization
Header Value : Bearer {{your-api-key}}
### Authentication error response
If an API key is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code.
## Need some help?
In case you have any questions, feel free to contact us.'
license:
name: SiteGPT Terms and Conditions
url: https://sitegpt.ai/terms
version: 1.0.0
contact:
name: Bhanu Teja P
email: bhanu@sitegpt.ai
url: mailto:bhanu@sitegpt.ai
servers:
- url: https://sitegpt.ai/api
security:
- bearerAuth: []
tags:
- name: Chatbot Icons
x-displayName: Icons
description: APIs to manage (add/update/delete) icons related to a particular chatbot.
x-mint:
icon: icons
paths:
/v0/chatbots/{chatbotId}/icons:
parameters:
- schema:
type: string
name: chatbotId
in: path
required: true
description: Id of the chatbot
post:
tags:
- Chatbot Icons
summary: Update Chatbot Icons
requestBody:
content:
multipart/form-data:
schema:
type: object
description: Request Body
properties:
iconType:
example: CHAT_BUBBLE
description: Type of the icon
enum:
- BOT
- PERSON
- AGENT
- WATERMARK
- CHAT_BUBBLE
iconSrc:
type: string
format: binary
description: Icon file
required:
- iconType
- iconSrc
description: Request body to add/update the chatbot icons
parameters:
- name: chatbotId
description: Id of the chatbot
in: path
schema:
type: string
required: true
responses:
'200':
description: OK
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
type: object
description: Success Response
properties:
success:
type: boolean
description: Indicates whether this is success response or error response
message:
type: string
description: Overall message regarding the operation performed
data:
type:
- object
- 'null'
description: Data returned from the server
examples:
Success:
value:
success: true
message: Updated the chatbot icon successfully
data: null
'400':
description: Bad Request
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Validation Error:
value:
success: false
message: Failed to update the chatbot icon
data: null
error:
code: CHATBOT_ID_REQUIRED
message: chatbotId is required
details: null
'401':
description: Unauthorized
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Authentication Error:
value:
success: false
message: Failed to update the chatbot icon
data: null
error:
code: API_KEY_NOT_VALID
message: Authorization header does not contain valid API key
details: null
'403':
description: Forbidden
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Forbidden Error:
value:
success: false
message: Failed to update the chatbot icon
data: null
error:
code: CHATBOT_ICONS_UPDATE_DELETE_FORBIDDEN
message: You are not authorized to add links to this chatbot
details: null
'405':
description: Method Not Allowed
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Method Not Allowed Error:
value:
success: false
message: Failed to update the chatbot icon
data: null
error:
code: REQUEST_METHOD_NOT_ALLOWED
message: PATCH request method is not allowed
details: null
'500':
description: Internal Server Error
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Server Error:
value:
success: false
message: Failed to update the chatbot icon
data: null
error:
code: CHATBOT_ICON_UPDATE_FAILED
message: Some technical error has occurred !!
details: null
operationId: add-update-chatbot-icons
description: Add or Update the chatbot icons (Bot Icon, Person Icon, Agent Icon, Watermark Icon, Chat Bubble Icon)
delete:
tags:
- Chatbot Icons
summary: Delete Chatbot Icons
parameters:
- name: chatbotId
description: Id of the chatbot
in: path
schema:
type: string
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
description: Success Response
properties:
success:
type: boolean
description: Indicates whether this is success response or error response
message:
type: string
description: Overall message regarding the operation performed
data:
type:
- object
- 'null'
description: Data returned from the server
headers:
Content-Type:
schema:
type: string
description: application/json
'400':
description: Bad Request
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Validation Error:
value:
success: false
message: Failed to delete the chatbot icon
data: null
error:
code: CHATBOT_ID_REQUIRED
message: chatbotId is required
details: null
'401':
description: Unauthorized
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Authentication Error:
value:
success: false
message: Failed to delete the chatbot icon
data: null
error:
code: API_KEY_NOT_VALID
message: Authorization header does not contain valid API key
details: null
'403':
description: Forbidden
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Forbidden Error:
value:
success: false
message: Failed to delete the chatbot icon
data: null
error:
code: CHATBOT_ICONS_UPDATE_DELETE_FORBIDDEN
message: You are not authorized to add links to this chatbot
details: null
'405':
description: Method Not Allowed
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Method Not Allowed Error:
value:
success: false
message: Failed to delete the chatbot icon
data: null
error:
code: REQUEST_METHOD_NOT_ALLOWED
message: PATCH request method is not allowed
details: null
'500':
description: Internal Server Error
headers:
Content-Type:
schema:
type: string
description: application/json
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Server Error:
value:
success: false
message: Failed to delete the chatbot icon
data: null
error:
code: CHATBOT_ICON_DELETE_FAILED
message: Some technical error has occurred !!
details: null
description: Delete the chatbot icon
operationId: delete-chatbot-icon
components:
schemas:
ErrorResponse:
type: object
description: Error Response
properties:
success:
type: boolean
description: Indicates that this is error response
message:
type: string
description: Overall error message regarding the operation performed
data:
type:
- object
- 'null'
description: Data returned from the API. This will be `null` for errors
error:
type: object
description: Object with the error details
properties:
code:
type: string
description: Based on this error code, you can identify what is the error
message:
type: string
description: The message indicating the reason for the error
details:
type:
- array
- 'null'
description: More details on the error. Applicable only for Validation errors
items:
type: object
properties:
path:
type: array
description: Specifies the path in request body where error occurred. If the error field is nexted, then this array length will be more than 1.
items:
oneOf:
- type: string
description: Specifies the name of the field
- type: integer
description: Specifies the position in an array
message:
type: string
description: Reason for the error of the path mentioned before
securitySchemes:
bearerAuth:
type: http
scheme: bearer