MCP / Tools / Other / account_mutate

account_mutate

writebetaauth: account:writeapproval: suggeststatus: v1

Update caller-scoped account preferences such as the default BeatBandit LLM identifier and default video model path.

When to use

Use to change the caller's own default BeatBandit account preferences.
Use to update the saved default video model that BeatBandit should prefer when a video workflow omits `model_path`.

When not to use

Do not use for project-scoped defaults or settings; read `project_preferences` and use `project_mutate` for project-level changes instead.
Do not use to inspect which model a completed BeatBandit job actually used; use `job_get` instead.

Examples

“Set my default LLM to `anthropic/claude-sonnet-4`.”
“Set my default video model to `fal-ai/vidu/q3/image-to-video/turbo`.”
“Update my account-level defaults before starting new BeatBandit workflows.”

Anti-examples

Change this project's template settings.
Tell me which model the finished screenplay generation job used.

Backend capabilities

account.mutate

Linked resources

Tool calls may return resource_links pointing at these resource families.

account_status

Input schema

account_mutate input

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": [
    "operation",
    "preferences"
  ],
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "preferences_update"
      ]
    },
    "if_match_updated_at": {
      "type": "string"
    },
    "preferences": {
      "type": "object",
      "properties": {
        "default_llm_identifier": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300
        },
        "default_video_model_path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 400
        }
      },
      "additionalProperties": false,
      "anyOf": [
        {
          "required": [
            "default_llm_identifier"
          ]
        },
        {
          "required": [
            "default_video_model_path"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

Output schema

account_mutate output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": [
    "operation",
    "preferences_updated_at",
    "defaults"
  ],
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "preferences_update"
      ]
    },
    "preferences_updated_at": {
      "type": "string",
      "format": "date-time"
    },
    "defaults": {
      "type": "object",
      "required": [
        "default_llm_identifier",
        "default_video_model_path"
      ],
      "properties": {
        "default_llm_identifier": {
          "type": "string"
        },
        "default_video_model_path": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "resource_links": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  },
  "additionalProperties": true
}