Update conversation settings

POST 
/api/v1/llm/update-settings

Updates the conversation's behavior settings.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Build an assistant that researches the web · MCP server selection · Configure a support conversation that stays predictable · Let your assistant answer questions about a customer’s calendar

Request

Responses

200

Settings updated

Replace settings on an existing conversation; include every setting you want to retain.

Section ID: DOC-MA-conversations-api-updateSettings#example-conversations-updateSettings-request

Request example

{
  "conversationKey": "example_123",
  "settings": {
    "maxLoops": 6,
    "maxParallelTools": 3
  }
}

Guide request for 2. Enable research for the conversation. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-conversations-api-updateSettings#example-cookbook-integrations-tools-connections-index-02-request

Request example

{
  "conversationKey": "thread_abc123",
  "settings": {
    "mcpServers": [
      {
        "serverId": "built-in:tavily"
      }
    ]
  }
}

Guide request for Step 2: Keep one unresolved turn at a time. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-conversations-api-updateSettings#example-cookbook-managed-agents-conversations-configuration-02-request

Request example

{
  "conversationKey": "support-chat-001",
  "settings": {
    "interruptPolicy": "INTERRUPT_POLICY_REJECT_NEW",
    "maxLoops": 4
  }
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-MA-conversations-api-updateSettings#example-conversations-updateSettings-response

Response example

{
  "settings": {
    "interruptPolicy": "INTERRUPT_POLICY_REJECT_NEW",
    "maxLoops": 1,
    "maxParallelTools": 1,
    "mcpServers": [
      {
        "serverId": "example_123",
        "enabled": true,
        "priority": 1,
        "allowlistToolPatterns": [
          "example"
        ],
        "blocklistToolPatterns": [
          "example"
        ]
      }
    ],
    "toolPolicy": {
      "requireApprovalToolNamePatterns": [
        "example"
      ],
      "requireApprovalServerIds": [
        "example_123"
      ],
      "autoApproveToolNamePatterns": [
        "example"
      ],
      "autoApproveServerIds": [
        "example_123"
      ],
      "approvalMode": "APPROVAL_MODE_MIXED",
      "clientToolMode": "CLIENT_TOOL_MODE_MIXED",
      "approvalTimeoutMs": 1,
      "failOnApprovalTimeoutToolNamePatterns": [
        "example"
      ],
      "stableSortByCallIndexOnTie": true,
      "maxParallelToolCalls": 1,
      "maxToolCallsPerLoop": 1,
      "maxTotalToolCalls": 1,
      "retriableToolNamePatterns": [
        "example"
      ],
      "maxRetries": 1,
      "retryableErrorSubstrings": [
        "example"
      ],
      "nonRetryableErrorSubstrings": [
        "example"
      ],
      "clientToolTimeoutMs": 1,
      "failureMode": "FAILURE_MODE_CONTINUE"
    },
    "promptVariables": {
      "example": "value"
    }
  }
}

Document ID: DOC-MA-conversations-api-updateSettings. Section identities and revisions.

Section	Stable reference
Update conversation settings	DOC-MA-conversations-api-updateSettings#overview
Request	DOC-MA-conversations-api-updateSettings#request
Responses	DOC-MA-conversations-api-updateSettings#responses