> ## Documentation Index > Fetch the complete documentation index at: https://sitegpt.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update Chatbot Settings - Advanced > Update advanced settings of the chatbot ## OpenAPI ````yaml patch /v0/chatbots/{chatbotId}/settings/advanced openapi: 3.0.0 info: title: SiteGPT API Collection 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](https://sitegpt.ai/billing). 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](https://sitegpt.ai/billing). 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 x-displayName: Chatbots description: >- APIs to manage different chatbots. APIs include `Fetching All Chatbots`, `Creating New Chatbot`, Fetching One Chatbot`, `Updating Chatbot Appearance` and `Deleting Chatbot`. x-mint: icon: message-bot - name: Chatbot Appearance x-displayName: Appearance description: APIs to update appearance of the chatbot. x-mint: icon: palette - name: Chatbot Custom Content x-displayName: Custom Content description: APIs to modify custom content of the chatbot. x-mint: icon: file-pen - name: Chatbot Follow Up Prompts x-displayName: Follow-up Prompts description: >- APIs to manage `Follow up Prompts` of a particular chatbot. APIs include `Fetching All Follow up Prompts`, `Adding New Follow up Prompt`, `Fetching One Follow up Prompt`, `Updating Follow up Prompt` and `Deleting Follow up Prompt`. x-mint: icon: message-arrow-up - name: Chatbot Icons x-displayName: Icons description: APIs to manage (add/update/delete) icons related to a particular chatbot. x-mint: icon: icons - name: Chatbot Links x-displayName: Content & Training description: >- APIs to fetch internal links of any url and to add certain links to a particular chatbot. x-mint: icon: book-open - name: Chatbot Messages x-displayName: Messages description: >- APIs to send a message to a particular thread or start a new conversation with in a particular chatbot. x-mint: icon: messages - name: Chatbot Personas x-displayName: Personas description: APIs to manage personas of the chatbot. x-mint: icon: user-tie - name: Chatbot Prompts x-displayName: Instructions description: APIs to manage prompts of the chatbot. x-mint: icon: message-text - name: Chatbot Conversation Starters x-displayName: Conversation Starters description: >- APIs to manage `Conversation Starters` of a particular chatbot. APIs include `Fetching All Conversation Starters`, `Adding New Conversation Starter`, `Fetching One Conversation Starter`, `Updating Conversation Starter` and `Deleting Conversation Starter`. x-mint: icon: bolt - name: Chatbot Settings x-displayName: Settings description: >- APIs to update different settings of the chatbot. APIs include `General Settings`, `User Data Settings`, `Chat Mode Settings`, `Localization Settings` and `Advanced Settings`. x-mint: icon: gear - name: Chatbot Threads x-displayName: Threads description: >- APIs to manage threads related to a particular chatbot. APIs include `Fetching All Threads`, `Fetching One Thread` and `Update Thread`. x-mint: icon: message-lines - name: Whitelabel x-displayName: Whitelabel (Deprecated) description: >- APIs to manage whitelabel users. APIs include `Create Whitelabel User` and `Update Whitelabel User Quota`. x-mint: icon: tag paths: /v0/chatbots/{chatbotId}/settings/advanced: patch: tags: - Chatbot Settings summary: Update Chatbot Settings - Advanced description: Update advanced settings of the chatbot operationId: update-chatbot-advanced-settings parameters: - name: chatbotId description: Id of the chatbot in: path schema: type: string required: true requestBody: content: application/json: schema: type: object description: Request Body properties: creativity: $ref: '#/components/schemas/ChatbotCreativity' temperature: type: number minimum: 0 maximum: 2 multipleOf: 0.01 description: >- Creativity meter of the chatbot. This is valid only when creativity of the chatbot is custom topK: type: integer minimum: 1 maximum: 50 multipleOf: 1 description: >- Number of relevant chunks to be fetched for answering the question webhookUrl: type: string description: >- All messages are sent to this global webhook url if webhook url is not configured at thread level webhookToken: type: string description: >- This is the global webhook token that is sent in header in the calls made to the above webhook url for all messages if token is not configured at thread level examples: Request Body: value: creativity: conservative temperature: 1 topK: 3 webhookUrl: https://example.com webhookToken: abc123 description: Request body to update advanced settings of the chatbot responses: '200': description: OK headers: Content-Type: schema: type: string example: application/json 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 description: Data returned from the server nullable: true examples: Success: value: success: true message: Updated advanced settings of the chatbot successfully data: {} '400': description: Bad Request headers: Content-Type: schema: type: string example: application/json description: application/json content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Validation Error: value: success: false message: Failed to update advanced settings of the chatbot data: null error: code: CHATBOT_ID_REQUIRED message: chatbotId is required details: null Invalid Request Body: value: success: false message: Failed to update advanced settings of the chatbot data: null error: code: REQUEST_VALIDATION_FAILED message: Request body is not valid details: - path: - creativity message: >- Invalid enum value. Expected `restricted` | `conservative` | `creative` | `custom`, received `conservativ` '401': description: Unauthorized headers: Content-Type: schema: type: string example: application/json description: application/json content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Authentication Error: value: success: false message: Failed to update advanced settings of the chatbot 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 example: application/json description: application/json content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Forbidden Error: value: success: false message: Failed to update advanced settings of the chatbot data: null error: code: CHATBOT_ADVANCED_SETTINGS_UPDATE_FORBIDDEN message: >- You are not authorized to update advanced settings of this chatbot details: null '405': description: Method Not Allowed headers: Content-Type: schema: type: string example: application/json description: application/json content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Method Not Allowed Error: value: success: false message: Failed to update advanced settings of the chatbot data: null error: code: REQUEST_METHOD_NOT_ALLOWED message: POST request method is not allowed details: null '500': description: Internal Server Error headers: Content-Type: schema: type: string example: application/json description: application/json content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Server Error: value: success: false message: Failed to update advanced settings of the chatbot data: null error: code: CHATBOT_ADVANCED_SETTINGS_UPDATE_FAILED message: Some technical error has occurred !! details: null components: schemas: ChatbotCreativity: title: Chatbot-Creativity description: Options of the creativity for the chatbot enum: - restricted - conservative - creative - custom 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 description: Data returned from the API. This will be `null` for errors nullable: true 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 description: More details on the error. Applicable only for Validation errors nullable: true 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 ````