# Cloud agents

Cloud agents are agents Foxora hosts for you. Use them when an agent needs to keep running on a schedule, respond to webhooks, or stay alive when your laptop is closed.

## When to reach for a cloud agent

- Daily / hourly summaries (digest emails, KPI reports).
- Inbox triage that runs while you sleep.
- Webhook responders — e.g. an agent that triages incoming Stripe events.
- Long-running workflows that exceed a single chat session.

## Setting one up

- Open Dashboard → Cloud agents.
- Click + New cloud agent.
- Pick a crew and tier, give it instructions, and add the tools it needs.
- Choose a trigger: Manual, Schedule (cron), or Webhook.
- Save. The agent is live and runs on the next trigger.

## Schedules

Cloud agents accept standard cron expressions. A few examples:

```
# Every hour at :00
0 * * * *

# Every weekday at 09:30
30 9 * * 1-5

# First of every month at 06:00
0 6 1 * *
```

## Webhooks

Each webhook-triggered agent gets a unique URL of the form https://api.foxora.ai/v1/agents/<id>/invoke. Send a POST with a JSON body and the agent will start processing it.

```
curl -X POST https://api.foxora.ai/v1/agents/AGENT_ID/invoke \
  -H "Authorization: Bearer $FOXORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "input": "Hello from a webhook" }'
```

## Logs & debugging

Every cloud agent run shows up in Dashboard → Usage with the prompt, the tool calls it made, and the final output. Failed runs keep their error trace for 30 days.

> Concurrency limitsFree plans run one cloud agent at a time. Pro and Team plans get progressively higher concurrency. See Plans & pricing.