Skip to main content
By default, Runchats only run when you trigger them in the Editor. You can also schedule an agent to run on a fixed interval, useful for polling data sources, generating recurring content, or sending alerts. A scheduled agent can simply run a workflow as it is, or it can run a prompt on the workflow each time.

Scheduling a workflow

You can schedule a workflow from two places:
  • In the editor: open the title menu (the workflow name, top left), choose Schedule, and pick Hourly, Daily, Weekly, or Monthly.
  • On the dashboard: open the workflow’s … menu (or right-click its card), choose Schedule, and pick an interval.
An agent will run the workflow automatically at that cadence.
The workflow menu on the dashboard showing the Schedule submenu with Hourly, Daily, Weekly, and Monthly options

Removing a schedule

Open the Schedule submenu again and choose Remove schedule. To stop a schedule without removing it, choose Pause from the agent’s menu on the Agents page.

Viewing scheduled agents

Browse all your scheduled agents on the Agents page. The week strip shows what’s scheduled and what ran each day, the Runs view shows the run history, and each agent’s menu lets you change its interval or Run now.

Running a prompt

Instead of running a workflow as it is, a scheduled agent can run a prompt on it. For example, check the latest outputs and summarise what changed, or edit and run nodes if you give it permission. On the Agents page, click New agent to set one up with instructions, a model, permissions and a credit budget per run.

Inputs

An agent that runs a workflow always uses the input values currently set on it. You can’t pass different inputs to different runs of the same agent. If you need to run a workflow on a schedule with varying inputs, use the Runchat API instead. Because of this constraint, scheduled agents are most useful when the workflow itself fetches fresh data when it runs. Common patterns:
  • Check a spreadsheet or database for new content
  • Check social media posts
  • Check forums, message boards, or marketplaces
  • Call external APIs (stock indexes, weather, etc.)

Outputs

Any workflow can be scheduled, but you won’t see the result the way you do in the editor or app view. Schedule workflows that act on the world outside Runchat rather than ones that produce a result you’d want to inspect. For example:
  • Write to a spreadsheet each week
  • Send an email or newsletter each month
  • Check an API endpoint every hour and send an alert if a condition is met
Scheduled runs consume credits or API tokens on every iteration. A workflow with large prompts running hourly can rack up costs fast, especially if it doesn’t actually need to run that often.

Next steps

  • Webhooks: trigger workflows from external events instead of on a fixed schedule
  • Agents: view and manage your scheduled and running agents
  • Runchat API: trigger workflows programmatically with custom inputs