account_query
Read the connected account's available BeatBandit credits and current model defaults without changing preferences or starting work.
When to use
- Use when the caller asks how many BeatBandit credits are available or which account defaults are selected.
- Credit balance is current account state; use job_get for a particular accepted job's settled charge and released reservation.
When not to use
- Use account_mutate for supported account preference changes on the general connection; the writing connection does not expose those changes.
- Use the selected workflow's quote phase for the cost of new work, not account_query.
Examples
- “How many BeatBandit credits do I have available?”
- “What is my account's default writing model?”
Anti-examples
- Start the missing scene. Use screenplay_generation_run after reviewing its quote.
Backend capabilities
account.query
Linked resources
Tool calls may return resource_links pointing at these resource families.
Input schema
account_query input
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false
}Output schema
account_query output
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"credits_balance",
"preferences_updated_at",
"defaults"
],
"properties": {
"credits_balance": {
"type": "number"
},
"preferences_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"defaults": {
"type": "object"
},
"allowed_llm_identifiers": {
"type": "array",
"items": {
"type": "string"
}
},
"allowed_video_model_paths": {
"type": "array",
"items": {
"type": "string"
}
},
"resource_links": {
"type": "array",
"items": {
"type": "object"
}
}
},
"additionalProperties": false
}← All toolsv1 · query_tool