update_application
Update application-level settings (name, active state, default language, language for everyone else, incoming-message behavior, the member notice when AI credits run out). Requires the manage_settings permission in that application. Only the fields you pass are changed; omitted fields keep their current value, so the call is idempotent. Returns the updated application.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "update_application"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New display name. Omit to leave unchanged. | |
| isActive | No | Set false to deactivate the application — its bots stop responding. Omit to leave unchanged. | |
| applicationId | No | Application (workspace) id. Optional: an application-scoped key (app_...) defaults to its own application, but a personal key (usr_...) has no default and omitting it fails with MCP_APPLICATION_REQUIRED. Call list_applications to get the id. | |
| defaultLanguage | No | New default language. It is the SOURCE language of the application's content: every block text is taken to be written in it, and translations are made from it. Any ISO 639 base language tag is accepted and normalised to its lowercase base form ("de", "pt-BR" → "pt"); a value that is not a 2-3 letter tag (for example "german") is rejected with INVALID_LANGUAGE — nothing falls back to "en". Changing it translates NOTHING: the texts already written are simply treated as written in the new language from then on, and the new default is dropped from the list of additional languages. Omit to leave unchanged. | |
| fallbackLanguage | No | Language for everyone else: the content language a contact gets when their own language is not one of the bot's languages (or unknown). Must be the default language or an enabled language; "" resets to the default language. Omit to leave unchanged. | |
| aiUnavailableNotices | No | The bot's "assistant unavailable" notice per language, e.g. { "it": "L'assistente non è disponibile al momento. Riprova più tardi." }: the one short sentence a member gets when an AI step is refused because the owner's AI credits ran out. Every language of the bot (default language + additional languages) needs one, written in that language; en, ru and es have a platform text. The result lists aiUnavailableNoticeMissingLanguages. Only the languages you pass change; "" removes one. Omit to leave unchanged. | |
| incomingMessageFlowId | No | Flow of this application to run for unmatched inbound messages. Required when incomingMessageBehavior is EXECUTE_FLOW. | |
| incomingMessageBehavior | No | What happens to an inbound message that matches no trigger: LIVE_CHAT routes it to a human operator, EXECUTE_FLOW runs the flow named by incomingMessageFlowId. Side effect of EXECUTE_FLOW: the platform also adds an "any message" MESSAGE trigger with originModuleKey "incoming_message_behavior" to that flow's start block, and removes it when this setting moves to another flow or back to LIVE_CHAT. It is system-owned: when you later resend that block's triggers with update_block, resend it unchanged with its id. |