> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ironlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tasks

> Run prompts automatically — on a schedule today, on events soon.

A **Task** is a prompt Foundry runs for you without you sitting in the chat. Set it up once, get answers on a cadence.

<Frame>
  <img src="https://mintcdn.com/ironaai/jz9FK1T3e0dey9ma/foundry/images/tasks/list.png?fit=max&auto=format&n=jz9FK1T3e0dey9ma&q=85&s=20e88267d768243011256e7cbdf12e56" alt="Scheduled Tasks page — Scheduled / Completed tabs, Triggers and New schedule buttons, empty state." width="3456" height="1872" data-path="foundry/images/tasks/list.png" />
</Frame>

## Two flavors

| Flavor                                              | What it is                                                        | Status      |
| --------------------------------------------------- | ----------------------------------------------------------------- | ----------- |
| **[Scheduled tasks](/foundry/tasks/scheduled)**     | Run on a cron — hourly, daily, weekly, or custom.                 | Live        |
| **[Event-based tasks](/foundry/tasks/event-based)** | Run when something happens (a webhook, a Zap, a connector event). | Coming soon |

Each task lands in your chat history under **Recent**, with an unread badge so you spot it the moment you next open Foundry.

## What a task does

Every task is essentially: *"run this prompt, with these connectors, on this schedule, and notify me."*

You configure:

* **Name and description** — what this task is for.
* **System prompt** *(optional)* — extra context that always applies.
* **Prompt** — what the assistant should do each run.
* **Connectors** — which connected services it can use.
* **Schedule** — cron or preset.
* **Lifetime cap** — max number of runs (default: 10).

## Why people use tasks

* **Daily brief** — *"summarize the top 10 X posts about AI infra from the last 24 hours"*, every morning at 8am.
* **Monitoring** — *"check competitor X's pricing page and tell me if it changed"*, every Monday.
* **Lead enrichment** — *"for each new row in this Notion DB, look up the company and append a one-line summary"* (via a connector).

## Related

<CardGroup cols={2}>
  <Card title="Scheduled tasks" icon="clock" href="/foundry/tasks/scheduled">
    The cron workflow.
  </Card>

  <Card title="Event-based tasks" icon="bolt" href="/foundry/tasks/event-based">
    Coming soon.
  </Card>

  <Card title="Tutorial: Automate" icon="play" href="/foundry/tutorials/automate-with-tasks">
    Build a daily brief.
  </Card>
</CardGroup>
