Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

Auto-update documentation for master (#77657)

github-automation-metabase8d3584593ae2
diff --git a/docs/api.json b/docs/api.json
index 6eddfbceb27..6482b665f21 100644
--- a/docs/api.json
+++ b/docs/api.json
@@ -3745,11 +3745,17 @@
"type" : "string",
"minLength" : 1
},
+ "tabs" : {
+ "type" : "array",
+ "items" : {
+ "$ref" : "#/components/schemas/metabase.agent-api.api.dashboard-tab"
+ }
+ },
"url" : {
"type" : "string"
}
},
- "required" : [ "id", "name", "url", "collection_id", "collection_path", "description", "dashcard_ids" ]
+ "required" : [ "id", "name", "url", "collection_id", "collection_path", "description", "dashcard_ids", "tabs" ]
},
"metabase.agent-api.api.create-metric-request" : {
"type" : "object",
@@ -3921,8 +3927,22 @@
},
"required" : [ "id", "name", "url", "display", "collection_id", "collection_path", "description" ]
},
+ "metabase.agent-api.api.dashboard-tab" : {
+ "type" : "object",
+ "properties" : {
+ "id" : {
+ "description" : "value must be an integer greater than zero.",
+ "type" : "integer",
+ "minimum" : 1
+ },
+ "name" : {
+ "type" : "string"
+ }
+ },
+ "required" : [ "id", "name" ]
+ },
"metabase.agent-api.api.dashcard-mutation" : {
- "description" : "One dashcard mutation. Discriminated on `:action`:\n - `add` : requires `card_id`. Auto-positioned. Optional `display_size`(\"wide\", \"tall\", or \"full\").\n - `remove` : requires `dashcard_id`.\n - `move` : requires `dashcard_id` and `position` (\"top\" or \"bottom\").",
+ "description" : "One dashcard mutation. Discriminated on `:action`:\n - `add` : requires `card_id`. Auto-positioned. Optional `display_size` (\"wide\", \"tall\", or \"full\").\n - `add_heading` : requires `text`. Adds a full-width section heading.\n - `add_text` : requires `text` (Markdown). Adds a text card. Optional `display_size`\n (\"wide\", \"tall\", or \"full\").\n - `update_text` : requires `dashcard_id` and `text`. Replaces a heading or text card's text\n in place, keeping its position and size.\n - `remove` : requires `dashcard_id`.\n - `move` : requires `dashcard_id` and `position` (\"top\" or \"bottom\").\n\n The add actions take an optional `tab_id` (a tab on this dashboard); omitted, new cards land on\n the dashboard's first tab.",
"oneOf" : [ {
"type" : "object",
"properties" : {
@@ -3941,9 +3961,89 @@
}, {
"type" : "null"
} ]
+ },
+ "tab_id" : {
+ "oneOf" : [ {
+ "description" : "value must be an integer greater than zero.",
+ "type" : "integer",
+ "minimum" : 1
+ }, {
+ "type" : "null"
+ } ]
+ }
+ },
+ "required" : [ "action", "card_id" ],
+ "additionalProperties" : false
+ }, {
+ "type" : "object",
+ "properties" : {
+ "action" : {
+ "const" : "add_heading"
+ },
+ "tab_id" : {
+ "oneOf" : [ {
+ "description" : "value must be an integer greater than zero.",
+ "type" : "integer",
+ "minimum" : 1
+ }, {
+ "type" : "null"
+ } ]
+ },
+ "text" : {
+ "type" : "string",
+ "minLength" : 1
}
},
- "required" : [ "action", "card_id" ]
+ "required" : [ "action", "text" ],
+ "additionalProperties" : false
+ }, {
+ "type" : "object",
+ "properties" : {
+ "action" : {
+ "const" : "add_text"
+ },
+ "display_size" : {
+ "oneOf" : [ {
+ "type" : "string",
+ "enum" : [ "wide", "tall", "full" ]
+ }, {
+ "type" : "null"
+ } ]
+ },
+ "tab_id" : {
+ "oneOf" : [ {
+ "description" : "value must be an integer greater than zero.",
+ "type" : "integer",
+ "minimum" : 1
+ }, {
+ "type" : "null"
+ } ]
+ },
+ "text" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ },
+ "required" : [ "action", "text" ],
+ "additionalProperties" : false
+ }, {
+ "type" : "object",
+ "properties" : {
+ "action" : {
+ "const" : "update_text"
+ },
+ "dashcard_id" : {
+ "description" : "value must be an integer greater than zero.",
+ "type" : "integer",
+ "minimum" : 1
+ },
+ "text" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ },
+ "required" : [ "action", "dashcard_id", "text" ],
+ "additionalProperties" : false
}, {
"type" : "object",
"properties" : {
@@ -3956,7 +4056,8 @@
"minimum" : 1
}
},
- "required" : [ "action", "dashcard_id" ]
+ "required" : [ "action", "dashcard_id" ],
+ "additionalProperties" : false
}, {
"type" : "object",
"properties" : {
@@ -3973,7 +4074,8 @@
"enum" : [ "top", "bottom" ]
}
},
- "required" : [ "action", "dashcard_id", "position" ]
+ "required" : [ "action", "dashcard_id", "position" ],
+ "additionalProperties" : false
} ]
},
"metabase.agent-api.api.execute-query-request" : {
@@ -4268,7 +4370,7 @@
"required" : [ "id", "type", "name" ]
},
"metabase.agent-api.api.update-dashboard-request" : {
- "description" : "Patch shape for `update_dashboard`. Metadata fields and an optional `dashcards` list of\n add/remove/move mutations applied in order.",
+ "description" : "Patch shape for `update_dashboard`. Metadata fields and an optional `dashcards` list of\n add/add_heading/add_text/update_text/remove/move mutations applied in order.",
"type" : "object",
"properties" : {
"archived" : {
@@ -4315,7 +4417,7 @@
}
},
"metabase.agent-api.api.update-dashboard-response" : {
- "description" : "Returned by `update_dashboard`. `:dashcard_ids` is the post-mutation list of dashcard\n ids in row/col order so the LLM can confirm what landed on the dashboard.",
+ "description" : "Returned by `update_dashboard`. `:dashcard_ids` is the post-mutation list of dashcard\n ids in row/col order so the LLM can confirm what landed on the dashboard. `:tabs` lists\n the dashboard's tabs in display order — the ids a mutation's `tab_id` accepts.",
"type" : "object",
"properties" : {
"archived" : {
@@ -4356,9 +4458,15 @@
"name" : {
"type" : "string",
"minLength" : 1
+ },
+ "tabs" : {
+ "type" : "array",
+ "items" : {
+ "$ref" : "#/components/schemas/metabase.agent-api.api.dashboard-tab"
+ }
}
},
- "required" : [ "id", "name", "collection_id", "collection_path", "description", "archived", "dashcard_ids" ]
+ "required" : [ "id", "name", "collection_id", "collection_path", "description", "archived", "dashcard_ids", "tabs" ]
},
"metabase.agent-api.api.update-metric-request" : {
"description" : "Patch shape for `update_metric`. Every field is optional; only the fields the caller\n passes are changed. `:query` accepts a base64-encoded MBQL string (or query_handle UUID\n resolved upstream in the MCP layer) and must still describe a valid metric.",
@@ -8661,7 +8769,7 @@
} ]
},
"template-tags" : {
- "$ref" : "#/components/schemas/metabase.lib.schema.template-tag.template-tag-map"
+ "$ref" : "#/components/schemas/metabase.lib.schema.template-tag.template-tags"
}
},
"required" : [ "lib/type" ]
@@ -11421,6 +11529,7 @@
"required" : [ "name", "display-name" ]
},
"metabase.lib.schema.template-tag.disallow-dimension" : { },
+ "metabase.lib.schema.template-tag.distinct-template-tags" : { },
"metabase.lib.schema.template-tag.field-filter" : {
"type" : "object",
"properties" : {
@@ -11626,14 +11735,15 @@
} ]
} ]
},
- "metabase.lib.schema.template-tag.template-tag-map" : {
+ "metabase.lib.schema.template-tag.template-tags" : {
+ "description" : "Prior to 63, this was a map, but was changed to a list to preserve order with more than 8 template tags.\n\n Each tag must have a distinct `:name`.",
"allOf" : [ {
- "type" : "object",
- "additionalProperties" : {
+ "type" : "array",
+ "items" : {
"$ref" : "#/components/schemas/metabase.lib.schema.template-tag.template-tag"
}
}, {
- "$ref" : "#/components/schemas/metabase.lib.schema.template-tag..template-tag-map.validate-names"
+ "$ref" : "#/components/schemas/metabase.lib.schema.template-tag.distinct-template-tags"
} ]
},
"metabase.lib.schema.template-tag.temporal-unit" : {
@@ -15329,7 +15439,7 @@
"put" : {
"operationId" : "put-api-agent-v1-dashboard-id",
"summary" : "PUT /api/agent/v1/dashboard/{id}",
- "description" : "Update a dashboard. Patch semantics - only fields you pass are changed.\n\n Metadata: `name`, `description`, `collection_id`, `archived`. Dashcard mutations\n are submitted under `dashcards` as a list of `{action: add|remove|move, ...}`\n entries applied in order. `add` requires `card_id`; `remove` and `move` require\n `dashcard_id`.",
+ "description" : "Update a dashboard. Patch semantics - only fields you pass are changed.\n\n Metadata: `name`, `description`, `collection_id`, `archived`. Dashcard mutations\n are submitted under `dashcards` as a list of\n `{action: add|add_heading|add_text|update_text|remove|move, ...}` entries applied in\n order. `add` requires `card_id`; `add_heading` and `add_text` require `text` (Markdown\n for text cards); `update_text`, `remove`, and `move` require `dashcard_id`.",
"parameters" : [ {
"in" : "path",
"name" : "id",
@@ -28708,6 +28818,327 @@
"tags" : [ "/api/ee/metabot" ]
}
},
+ "/api/ee/mfa/admin/overview" : {
+ "get" : {
+ "operationId" : "get-api-ee-mfa-admin-overview",
+ "summary" : "GET /api/ee/mfa/admin/overview",
+ "description" : "Admin: enrollment overview — how many users have (and haven't) set up a second factor, and\n whether the instance encrypts secrets at rest.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response",
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "encryption_key_set" : {
+ "type" : "boolean"
+ },
+ "enrolled_count" : {
+ "type" : "integer"
+ },
+ "unenrolled_count" : {
+ "type" : "integer"
+ }
+ },
+ "required" : [ "encryption_key_set", "enrolled_count", "unenrolled_count" ]
+ }
+ }
+ }
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "tags" : [ "/api/ee/mfa" ]
+ }
+ },
+ "/api/ee/mfa/admin/remove" : {
+ "post" : {
+ "operationId" : "post-api-ee-mfa-admin-remove",
+ "summary" : "POST /api/ee/mfa/admin/remove",
+ "description" : "Admin: remove a user's two-factor enrollment entirely — the lockout escape hatch for a lost\n authenticator with no recovery codes. Never feature-gated (a lapsed license must not make\n lockouts permanent). The affected user is notified by email. They re-enroll from scratch —\n there is nothing to \"reset\", the secret lives on their device.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response"
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "requestBody" : {
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "user_id" : {
+ "description" : "value must be an integer greater than zero.",
+ "type" : "integer",
+ "minimum" : 1
+ }
+ },
+ "required" : [ "user_id" ]
+ }
+ }
+ }
+ },
+ "tags" : [ "/api/ee/mfa" ]
+ }
+ },
+ "/api/ee/mfa/disable" : {
+ "post" : {
+ "operationId" : "post-api-ee-mfa-disable",
+ "summary" : "POST /api/ee/mfa/disable",
+ "description" : "Disable two-factor authentication for the current user. Re-auth is a fresh second factor — a\n TOTP code or an unused recovery code — never just the password.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response"
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "requestBody" : {
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "code" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ },
+ "required" : [ "code" ]
+ }
+ }
+ }
+ },
+ "tags" : [ "/api/ee/mfa" ]
+ }
+ },
+ "/api/ee/mfa/enroll" : {
+ "post" : {
+ "operationId" : "post-api-ee-mfa-enroll",
+ "summary" : "POST /api/ee/mfa/enroll",
+ "description" : "Start TOTP enrollment for the current user. Requires the account password (LDAP users re-bind\n against the directory) and the `:multi-factor-auth` feature. Returns the Base32 `secret` and an\n `otpauth_uri` for QR display; enrollment is not active until confirmed with a live code.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response",
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "otpauth_uri" : {
+ "type" : "string",
+ "minLength" : 1
+ },
+ "secret" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ },
+ "required" : [ "secret", "otpauth_uri" ]
+ }
+ }
+ }
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "requestBody" : {
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "password" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ },
+ "required" : [ "password" ]
+ }
+ }
+ }
+ },
+ "tags" : [ "/api/ee/mfa" ]
+ }
+ },
+ "/api/ee/mfa/enroll/confirm" : {
+ "post" : {
+ "operationId" : "post-api-ee-mfa-enroll-confirm",
+ "summary" : "POST /api/ee/mfa/enroll/confirm",
+ "description" : "Confirm TOTP enrollment by verifying a code from the authenticator app. Activates the second\n factor and returns the single-use recovery codes — the only time they exist in plaintext.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response",
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "recovery_codes" : {
+ "type" : "array",
+ "items" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ }
+ },
+ "required" : [ "recovery_codes" ]
+ }
+ }
+ }
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "requestBody" : {
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "code" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ },
+ "required" : [ "code" ]
+ }
+ }
+ }
+ },
+ "tags" : [ "/api/ee/mfa" ]
+ }
+ },
+ "/api/ee/mfa/recovery-codes" : {
+ "post" : {
+ "operationId" : "post-api-ee-mfa-recovery-codes",
+ "summary" : "POST /api/ee/mfa/recovery-codes",
+ "description" : "Regenerate the current user's recovery codes, invalidating the entire previous set. Re-auth is a\n fresh second factor — a TOTP code or an unused recovery code — so a stolen password alone can\n never rotate the codes. The plaintext codes are returned exactly once; only hashes are stored.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response",
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "recovery_codes" : {
+ "type" : "array",
+ "items" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ }
+ },
+ "required" : [ "recovery_codes" ]
+ }
+ }
+ }
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "requestBody" : {
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "code" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ },
+ "required" : [ "code" ]
+ }
+ }
+ }
+ },
+ "tags" : [ "/api/ee/mfa" ]
+ }
+ },
+ "/api/ee/mfa/status" : {
+ "get" : {
+ "operationId" : "get-api-ee-mfa-status",
+ "summary" : "GET /api/ee/mfa/status",
+ "description" : "The current user's MFA status, for the account-settings UI.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response",
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "enrolled" : {
+ "type" : "boolean"
+ },
+ "method" : {
+ "oneOf" : [ {
+ "type" : "string"
+ }, {
+ "type" : "null"
+ } ]
+ },
+ "mfa_enabled" : {
+ "type" : "boolean"
+ },
+ "pending" : {
+ "type" : "boolean"
+ },
+ "recovery_codes_remaining" : {
+ "type" : "integer"
+ }
+ },
+ "required" : [ "mfa_enabled", "enrolled", "pending", "method", "recovery_codes_remaining" ]
+ }
+ }
+ }
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "tags" : [ "/api/ee/mfa" ]
+ }
+ },
"/api/ee/permission_debug" : {
"get" : {
"operationId" : "get-api-ee-permission_debug",
@@ -31074,7 +31505,7 @@
"get" : {
"operationId" : "get-api-ee-semantic-search-status",
"summary" : "GET /api/ee/semantic-search/status",
- "description" : "Fetch the indexing status of the currently active semantic search index table.\n\n Returns a map with keys:\n :indexed_count <number of indexed items>\n :total_est <estimated total number of items to index>\n\n If no index is active, returns an empty map.",
+ "description" : "Fetch the indexing status of the currently active semantic search index table.\n\n Returns a map with keys:\n :indexed_count <number of indexed items>\n :total_est <estimated total number of items to index>\n\n If no index is active, or no pgvector database is configured, returns an empty map.",
"parameters" : [ ],
"responses" : {
"2XX" : {
@@ -33617,7 +34048,7 @@
"post" : {
"operationId" : "post-api-embed-mcp-feedback",
"summary" : "POST /api/embed-mcp/feedback",
- "description" : "Proxy MCP Apps visualization feedback to Harbormaster.",
+ "description" : "Persist MCP Apps visualization feedback.",
"parameters" : [ ],
"responses" : {
"2XX" : {
@@ -33690,20 +34121,17 @@
},
"issue_type" : {
"oneOf" : [ {
- "type" : "string"
+ "type" : "string",
+ "maxLength" : 64
}, {
"type" : "null"
} ]
},
- "message_id" : {
- "type" : "string",
- "minLength" : 1
- },
"positive" : {
"type" : "boolean"
}
},
- "required" : [ "message_id", "positive" ]
+ "required" : [ "positive" ]
}
},
"required" : [ "feedback", "conversation_data" ]
@@ -44985,6 +45413,98 @@
"tags" : [ "/api/session" ]
}
},
+ "/api/session/mfa/send-email-otp" : {
+ "post" : {
+ "operationId" : "post-api-session-mfa-send-email-otp",
+ "summary" : "POST /api/session/mfa/send-email-otp",
+ "description" : "Email a one-time code as a fallback second factor (for a user who lost their authenticator but\n still has recovery codes disabled or unavailable). Requires a valid challenge token from\n `POST /api/session`; the code is single-use with a 10-minute expiry and is accepted by\n `POST /mfa/verify` like any other code.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response",
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "success" : {
+ "const" : true
+ }
+ },
+ "required" : [ "success" ]
+ }
+ }
+ }
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "requestBody" : {
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "challenge_token" : {
+ "type" : "string",
+ "minLength" : 1
+ }
+ },
+ "required" : [ "challenge_token" ]
+ }
+ }
+ }
+ },
+ "tags" : [ "/api/session" ]
+ }
+ },
+ "/api/session/mfa/verify" : {
+ "post" : {
+ "operationId" : "post-api-session-mfa-verify",
+ "summary" : "POST /api/session/mfa/verify",
+ "description" : "Complete a two-step login by verifying a one-time code. Takes the `challenge_token` returned by\n `POST /api/session` and either the 6-digit `code` from the user's authenticator app, one of\n their single-use recovery codes, or an emailed one-time code; on success sets the session cookie.",
+ "parameters" : [ ],
+ "responses" : {
+ "2XX" : {
+ "description" : "Successful response"
+ },
+ "4XX" : {
+ "description" : "Client error response"
+ },
+ "5XX" : {
+ "description" : "Server error response"
+ }
+ },
+ "requestBody" : {
+ "content" : {
+ "application/json" : {
+ "schema" : {
+ "type" : "object",
+ "properties" : {
+ "challenge_token" : {
+ "type" : "string",
+ "minLength" : 1
+ },
+ "code" : {
+ "type" : "string",
+ "minLength" : 1
+ },
+ "remember" : {
+ "type" : "boolean"
+ }
+ },
+ "required" : [ "challenge_token", "code" ]
+ }
+ }
+ }
+ },
+ "tags" : [ "/api/session" ]
+ }
+ },
"/api/session/password-check" : {
"post" : {
"operationId" : "post-api-session-password-check",
diff --git a/docs/configuring-metabase/config-template.md b/docs/configuring-metabase/config-template.md
index 1aabd43a4b0..5b94cf97ab1 100644
--- a/docs/configuring-metabase/config-template.md
+++ b/docs/configuring-metabase/config-template.md
@@ -222,6 +222,8 @@ config:
metabot-enabled: true
metabot-recent-views-enabled: true
metabot-slack-signing-secret: null
+ mfa-challenge-signing-key: null
+ mfa-enforcement: 'off'
native-query-autocomplete-match-style: substring
nested-field-columns-value-length-limit: 50000
no-data-illustration: default
@@ -242,6 +244,9 @@ config:
premium-embedding-token: null
query-caching-max-kb: 2000
query-caching-max-ttl: 3024000.0
+ queue-backend: quartz
+ queue-max-retries: 5
+ queue-no-listener-max-age-ms: 86400000
redirect-all-requests-to-https: false
remote-sync-auto-import: false
remote-sync-auto-import-rate: 5
@@ -314,7 +319,6 @@ config:
sql-tools-parser-backend: sqlglot
ssh-heartbeat-interval-sec: 180
start-of-week: sunday
- static-viz-mode: graalvm
subscription-allowed-domains: null
surveys-enabled: true
sync-leaf-fields-limit: 1000
diff --git a/docs/configuring-metabase/environment-variables.md b/docs/configuring-metabase/environment-variables.md
index f7298fb3e1d..600f6bf5e06 100644
--- a/docs/configuring-metabase/environment-variables.md
+++ b/docs/configuring-metabase/environment-variables.md
@@ -1394,6 +1394,21 @@ Whether the user's recently viewed items are included in the Metabot system prom
Signing secret for verifying requests from the Metabot Slack app.
+### `MB_MFA_CHALLENGE_SIGNING_KEY`
+
+- Type: string
+- Default: `null`
+
+Key used to sign MFA challenge tokens. Generated automatically on first use.
+
+### `MB_MFA_ENFORCEMENT`
+
+- Type: keyword
+- Default: `off`
+- [Configuration file name](./config-file.md): `mfa-enforcement`
+
+Controls whether two-factor authentication is available to users. :off disables it entirely; :optional allows users to enroll voluntarily.
+
### `MB_NATIVE_QUERY_AUTOCOMPLETE_MATCH_STYLE`
- Type: keyword
@@ -1581,6 +1596,27 @@ The maximum size of the cache, per saved question, in kilobytes.
The absolute maximum time to keep any cached query results, in seconds.
+### `MB_QUEUE_BACKEND`
+
+- Type: string
+- Default: `quartz`
+
+Which queue backend to use. Valid values: `quartz`, `memory`.
+
+### `MB_QUEUE_MAX_RETRIES`
+
+- Type: integer
+- Default: `5`
+
+Maximum number of times a failed queue message will be retried before being dropped.
+
+### `MB_QUEUE_NO_LISTENER_MAX_AGE_MS`
+
+- Type: integer
+- Default: `86400000`
+
+How long (in milliseconds) a Quartz queue message with no listener anywhere in the cluster is kept before the reaper drops it. With node-affinity, such a message is never acquired and just waits in the store; this bounds that wait so a message for a queue no node handles (e.g. a new queue whose node was rolled back) does not linger forever. Generous by default (1 day) so a node can restart or be re-upgraded and still deliver it.
+
### `MB_REDIRECT_ALL_REQUESTS_TO_HTTPS`
- Type: boolean
@@ -2242,15 +2278,6 @@ Controls how often the heartbeats are sent when an SSH tunnel is established (in
This will affect things like grouping by week or filtering in GUI queries. It won't affect most SQL queries, although it is used to set the WEEK_START session variable in Snowflake.
-### `MB_STATIC_VIZ_MODE`
-
-- Type: keyword
-- Default: `graalvm`
-
-How static visualizations (subscription/alert charts and pulse table cell colors) are rendered:
- `graalvm` runs the JavaScript in-process on a pooled GraalVM context (default), or `node` runs it in a
- pool of external Node.js child processes (requires a `node` binary on the host's PATH).
-
### `MB_SUBSCRIPTION_ALLOWED_DOMAINS`
> Only available on Metabase [Pro](https://www.metabase.com/product/pro) and [Enterprise](https://www.metabase.com/product/enterprise) plans.
diff --git a/docs/usage-and-performance-tools/usage-analytics-reference.md b/docs/usage-and-performance-tools/usage-analytics-reference.md
index c430b94a20c..a81ec57eb29 100644
--- a/docs/usage-and-performance-tools/usage-analytics-reference.md
+++ b/docs/usage-and-performance-tools/usage-analytics-reference.md
@@ -604,6 +604,9 @@ The Topic column on the [Activity log](#activity-log) model takes one of:
- measure-create
- measure-delete
- measure-update
+- mfa-disabled
+- mfa-enrolled
+- mfa-verification-failed
- notification-create
- notification-unsubscribe
- notification-unsubscribe-ex