update_assistant

Args:
    assistant_id: Required. ID of the assistant to update.
    name: Optional. Name of the assistant.
    model: Optional. Model to use for the assistant.
    instructions: Optional. Core instructions or behaviors for the agent.
    description: Optional. A summary of the agent's purpose.
    tools: Optional. List of tools for the assistant, each containing:
        - type: Required. Type of tool (ANY of "hangup", "retrieval", "send_dtmf",
          "transfer", "webhook").
        - retrieval: Optional. For retrieval tools, contains:
            - bucket_ids: Required. List of bucket IDs for retrieval.
            - max_num_results: Optional. Maximum number of results to retrieve.
        - webhook: Optional. For webhook tools, contains:
            - name: Required. The name of the tool.
            - description: Required. The description of the tool.
            - url: Required. The URL of the external tool to be called. This URL can be
              templated like: https://example.com/api/v1/{id}, where {id} is a
              placeholder for a value that will be provided by the assistant if
              path_parameters are provided with the id attribute.
            - method: Optional. The HTTP method to be used. Possible values:
              [GET, POST, PUT, DELETE, PATCH]. Default value: POST.
            - headers: Optional. Array of header objects with:
                - name: String name of the header.
                - value: String value of the header. Supports mustache templating,
                  e.g., Bearer {{#integration_secret}}test-secret{{/integration_secret}}.
                  Secrets can be found in `list_integration_secrets`
            - body_parameters: Optional. JSON Schema object describing the body parameters:
                - properties: Object defining the properties of the body parameters.
                - required: Array of strings listing required properties.
                - type: String. Possible value: "object".
            - path_parameters: Optional. JSON Schema object describing the path parameters:
                - properties: Object defining the properties of the path parameters.
                - required: Array of strings listing required properties.
                - type: String. Possible value: "object".
            - query_parameters: Optional. JSON Schema object describing the query parameters:
                - properties: Object defining the properties of the query parameters.
                - required: Array of strings listing required properties.
                - type: String. Possible value: "object".
        - hangup: Optional. For hangup tools, contains:
            - description: Optional. Description of the hangup function.
        - send_dtmf: Optional. For DTMF tools, contains an empty object. This tool
          allows sending DTMF tones during a call.
        - transfer: Optional. For transfer tools, contains:
            - targets: Required. Array of transfer targets, each with:
                - name: Optional. Name of the target.
                - to: Required. Destination number or SIP URI.
            - from: Required. Number or SIP URI placing the call.
            - custom_headers: Optional. Array of custom SIP headers, each with:
                - name: Required. Name of the header.
                - value: Required. Value of the header. Supports mustache templating.
                eg: {{#integration_secret}}test-secret{{/integration_secret}}
                to be used with integration secrets (Available secrets can be
                found in `list_integration_secrets`)
    greeting: Optional. A short welcoming message used by the agent.
    llm_api_key_ref: Optional. LLM API key reference. This is meant to be used
    for models provided by external vendors. eg: openai, anthropic, Groq, xai-org.
    Available secrets can be found in `list_integration_secrets`
    transcription: Optional. Transcription settings with:
        - model: Optional. Model to use for transcription.
    telephony_settings: Optional. Telephony settings with:
        - default_texml_app_id: Optional. Default TeXML application ID.
    messaging_settings: Optional. Messaging settings with:
        - default_messaging_profile_id: Optional. Default messaging profile ID.
        - delivery_status_webhook_url: Optional. Webhook URL for delivery status updates.
    insight_settings: Optional. Insight settings with:
        - insight_group_id: Optional. Insight group ID.
    dynamic_variables_webhook_url: Optional. Dynamic variables webhook URL.
    dynamic_variables: Optional. Dynamic variables dictionary.

Returns:
    Dict[str, Any]: Response data