# Update Mentor Settings

Update various mentor settings including system prompts, tool permissions, and UI configurations.

Endpoint: PUT /api/ai-mentor/orgs/{org}/users/{user_id}/mentors/{mentor}/settings/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `department_id` (integer)
    Department to authorize users by

## Path parameters:

  - `mentor` (string, required)

  - `org` (string, required)

  - `user_id` (string, required)

## Request fields (multipart/form-data):

  - `mentor_name` (string)

  - `template_name` (string)

  - `display_name` (string)

  - `profile_image` (string)

  - `initial_message` (string,null)

  - `suggested_message` (string,null)

  - `theme` (string)

  - `user_message_color` (string)

  - `mentor_bubble_color` (string)

  - `align_mentor_bubble` (string)

  - `system_prompt` (string)

  - `llm_provider` (string)

  - `llm_name` (string)

  - `featured` (boolean)

  - `disable_chathistory` (boolean)

  - `metadata` (any,null)

  - `custom_css` (string,null)

  - `department_id` (integer,null)
    Department to authorize users by

  - `mentor_visibility` (string)

  - `enable_image_generation` (boolean)

  - `enable_web_browsing` (boolean)

  - `enable_code_interpreter` (boolean)

  - `allow_anonymous` (boolean)

  - `forkable` (boolean)

  - `forkable_with_training_data` (boolean)

  - `mentor_description` (string)

  - `uploaded_profile_image` (string)

  - `proactive_response` (string)

  - `greeting_method` (string)
    *  - Proactive Prompt
*  - Proactive Response
    Enum: "proactive_prompt", "proactive_response"

  - `can_use_tools` (boolean)

  - `tool_slugs` (array)

  - `llm_temperature` (number)

  - `proactive_prompt` (string)

  - `moderation_system_prompt` (string)

  - `post_processing_prompt` (string)

  - `moderation_response` (string)

  - `enable_moderation` (boolean)

  - `enable_post_processing_system` (boolean)

  - `enable_openai_assistant` (boolean)

  - `enable_total_grounding` (boolean)

  - `enable_suggested_prompts` (boolean,null)

  - `enable_guided_prompts` (boolean,null)

  - `mcp_servers` (array,null)

  - `google_voice` (integer)

  - `openai_voice` (integer)

  - `guided_prompt_instructions` (string,null)

  - `safety_system_prompt` (string)

  - `safety_response` (string)

  - `enable_safety_system` (boolean)

  - `enable_memory_component` (boolean)

  - `enable_spaced_repetition` (boolean)

  - `enable_instruction_mode` (boolean)

  - `enable_socratic_mode` (boolean)

  - `is_guided_mentor` (boolean)

  - `enable_email_chat` (boolean)

  - `categories` (array)

## Response 200 fields (application/json):

  - `id` (integer, required)

  - `display_name` (string,null)

  - `profile_image` (string,null)

  - `initial_message` (string,null)

  - `suggested_message` (string,null)

  - `theme` (string)
    *  - Dark
*  - Light
    Enum: "dark", "light"

  - `user_message_color` (string)

  - `mentor_bubble_color` (string)

  - `align_mentor_bubble` (string)
    *  - Left
*  - Right
    Enum: "left", "right"

  - `mentor` (string, required)

  - `mentor_slug` (string, required)

  - `mentor_unique_id` (string, required)

  - `metadata` (any, required)

  - `mentor_visibility` (any,null)

  - `enable_image_generation` (boolean,null)

  - `enable_web_browsing` (boolean,null)

  - `enable_code_interpreter` (boolean,null)

  - `custom_css` (string,null)

  - `allow_anonymous` (boolean, required)

  - `mentor_description` (string, required)

  - `suggested_prompts` (any, required)

  - `proactive_response` (string, required)

  - `greeting_method` (string, required)

  - `mentor_tools` (any, required)

  - `can_use_tools` (boolean, required)

  - `llm_name` (string, required)

  - `proactive_prompt` (string, required)

  - `enable_memory_component` (boolean, required)

  - `enable_email_chat` (boolean, required)

  - `enable_spaced_repetition` (boolean, required)

  - `enable_instruction_mode` (boolean, required)

  - `enable_socratic_mode` (boolean, required)

  - `is_guided_mentor` (boolean, required)

  - `enable_guided_prompts` (boolean, required)

  - `enable_moderation` (boolean, required)

  - `enable_post_processing_system` (boolean, required)

  - `enable_safety_system` (boolean, required)

  - `forkable` (boolean, required)

  - `forkable_with_training_data` (boolean, required)

  - `system_prompt` (string, required)

  - `llm_provider` (string, required)

  - `llm_temperature` (number, required)

  - `safety_system_prompt` (string, required)

  - `safety_response` (string, required)

  - `moderation_system_prompt` (string, required)

  - `post_processing_prompt` (string, required)

  - `moderation_response` (string, required)

  - `mcp_servers` (array, required)

  - `mcp_servers.platform` (integer, required)

  - `mcp_servers.name` (string, required)

  - `mcp_servers.url` (string, required)
    The url of the MCP server.

  - `mcp_servers.transport` (string)
    *  - Sse
*  - Websocket
    Enum: "sse", "websocket"

  - `mcp_servers.headers` (any)
    Headers to send to the MCP server. Useful for authentication,

  - `mcp_servers.platform_key` (string, required)

  - `mcp_servers.created_at` (string, required)

  - `mcp_servers.updated_at` (string, required)

  - `department` (string, required)

  - `disable_chathistory` (string, required)

  - `call_configuration` (object, required)

  - `call_configuration.mode` (string)
    *  - Realtime
*  - Inference
    Enum: "realtime", "inference"

  - `call_configuration.tts_provider` (string)
    *  - Openai
*  - Google
*  - Elevenlabs
    Enum: "openai", "google", "elevenlabs"

  - `call_configuration.stt_provider` (string)
    *  - Openai
*  - Google
*  - Deepgram
*  - Cartesia
    Enum: "openai", "google", "deepgram", "cartesia"

  - `call_configuration.llm_provider` (string)
    *  - Openai
*  - Google
    Enum: "openai", "google"

  - `call_configuration.use_function_calling_for_rag` (boolean)
    Whether to use function calls in the agent or force RAG calls before LLM generation

  - `call_configuration.google_voice` (object)

  - `call_configuration.google_voice.provider` (string, required)
    *  - Openai
*  - Google
*  - Elevenlabs
    Enum: "openai", "google", "elevenlabs"

  - `call_configuration.google_voice.language` (string)

  - `call_configuration.google_voice.description` (string)

  - `call_configuration.google_voice.audio_url` (string, required)

  - `call_configuration.openai_voice` (object)

  - `call_configuration.openai_voice_id` (integer,null, required)

  - `call_configuration.google_voice_id` (integer,null, required)

  - `call_configuration.enable_video` (boolean)
    Whether to enable video for the call. (applicable only for realtime mode)