Valta Docs
Automations
Coming Q3 2026. Not available in beta.
An automation runs your agent automatically based on a schedule or an event. Instead of calling agents.run() manually, you configure the automation once and it executes without you.
Example: every day at 9am UTC, run the Wallet Guardian agent with the task: Check all agent wallets and alert me if any are below $20.
Schedule-based automation
ts
const automation = await valta.automations.create({
agentId: agent.id,
name: 'Daily Wallet Check',
task: 'Check all agent wallets and alert if any balance is below $20.',
schedule: {
type: 'daily',
time: '09:00',
timezone: 'UTC',
},
})
Event-triggered automation
ts
const eventAuto = await valta.automations.create({
agentId: agent.id,
name: 'Low Balance Alert',
task: 'My wallet is low. Analyse recent spending and recommend where to cut costs.',
trigger: {
type: 'wallet_balance_below',
threshold: 10,
},
})
Schedule types
| Type | Description |
|---|---|
every_hour | Runs once per hour |
every_day | Runs at a specified time each day |
every_week | Runs on a specified day and time each week |
every_month | Runs on a specified day of the month |
cron | Full cron expression for advanced scheduling |
Event triggers
| Trigger | Fires when |
|---|---|
wallet_balance_below | Wallet drops below a specified threshold |
policy_violation | Agent attempts an action that violates policy |
agent_frozen | Any agent in your account is frozen |
transaction_completed | A transaction completes successfully |
Audit trail
Every automation trigger and every run it initiates gets a full audit trail entry. You can see exactly when the automation fired, which task was passed to the agent, and what the agent did.