account_mutate
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
Linked resources
Tool calls may return resource_links pointing at these resource families.
Input schema
{
"$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
{
"$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
}