Skip to main content
Tasks let you schedule prompts that run automatically - on a schedule, at a specific time, or on a recurring interval. Use them for daily check-ins, periodic reports, automated workflows, or anything else you want your agent to do without you having to ask.
Image

​
Create a Task

Open your agent → Tasks → + ADD. You’ll configure:
  1. Name - What to call this task
  2. Schedule - When it runs
  3. Prompt - What to tell your agent
  4. Delivery - Where to send the response (optional)

​
Schedule Types

Cron expression - Standard cron syntax for complex schedules. 
0 9 * * *      # Every day at 9am
0 */6 * * *    # Every 6 hours
0 9 * * 1-5    # Weekdays at 9am
Interval - Run every N minutes/hours. One-time - Run once at a specific date and time. You can also set a timezone so schedules run at the right local time.

​
Prompt

This is what your agent receives when the task runs. Write it like you’re sending a message:
  • “Check my portfolio and summarize any significant changes”
  • “Review yesterday’s logs and flag anything unusual”
  • “Generate the weekly status report”
You can optionally specify which model to use and a timeout.

​
Message Type

Tasks can deliver prompts in two ways:
  • Agent Message - The default. Your prompt is delivered as a chat message. Use this for most tasks.
  • System Event - Delivered as a system-level event rather than a chat message. Use this for heartbeat checks or maintenance tasks.

​
Delivery

By default, task results stay in your agent’s conversation history. But you can also: Announce to a channel - Send the response to Telegram, Slack, or Discord. Useful for alerts or reports you want pushed to you. Webhook - POST the response to a URL. Useful for integrations with other systems.

​
Managing Tasks

Your tasks list shows each task with its schedule and status. Run now - Trigger a task immediately without waiting for the schedule. Enable/disable - Pause a task without deleting it. Edit - Change the schedule, prompt, or delivery settings. Delete - Remove the task entirely.

​
Run History

Click a task to see its run history - when it ran, whether it succeeded, and what the agent responded.

​
Using the CLI

# List tasks
pinata agents tasks list <agent-id>

# Create a task
pinata agents tasks create <agent-id>

# Run a task now
pinata agents tasks run <agent-id> <task-id>

# Delete a task
pinata agents tasks delete <agent-id> <task-id>

​
Limits

  • Up to 20 tasks per agent
  • Minimum interval is 1 minute