Scheduled Tasks

Use Terraform to manage Scheduled Tasks in Kubiya:

You can use IaC to schedule tasks you want your AI Teammate to perform.

Want to know more about Scheduled Tasks in Kubiya? Learn more

kubiya_scheduled_task (Resource)

Provides a Kubiya Scheduled Task resource. This allows scheduled tasks to be created, updated, and deleted on the Kubiya platform. Scheduled tasks execute a Kubiya agent on a defined schedule.

Example Usage

# Daily task example
resource "kubiya_scheduled_task" "daily_backup_check" {
  name        = "daily-backup-check"
  description = "Verify backup completion daily"
  agent       = kubiya_agent.example.name
  schedule    = "0 9 * * *"  # 9 AM daily in cron format
  prompt      = "Check if all daily backups completed successfully"
  enabled     = true
  
  notification {
    method      = "Slack"
    destination = "#backups"
  }
}

# Weekday task example
resource "kubiya_scheduled_task" "weekly_report" {
  name        = "weekly-infrastructure-report"
  description = "Generate weekly infrastructure report"
  agent       = kubiya_agent.example.name
  schedule    = "0 10 * * MON"  # 10 AM every Monday
  prompt      = "Generate a comprehensive infrastructure status report for the past week"
  
  notification {
    method      = "Email"
    destination = "[e-mail]"
  }
}

# Every 15 minutes task
resource "kubiya_scheduled_task" "monitoring_check" {
  name        = "service-health-check"
  description = "Check critical service health"
  agent       = kubiya_agent.monitoring.name
  schedule    = "*/15 * * * *"  # Every 15 minutes
  prompt      = "Check health status of critical services"
  
  notification {
    method      = "Teams"
    team_name   = "Operations"
    destination = "Alerts"
  }
}

Argument Reference

The following arguments are supported:

Required Arguments

• name - (Required) The name of the scheduled task.

• description - (Required) A description of the scheduled task.

• agent - (Required) The name of the agent to execute.

• schedule - (Required) A cron expression defining when the task should run. For example:

  • 0 9 * * * - Daily at 9 AM

  • 0 9 * * MON-FRI - Weekdays at 9 AM

  • 0 0 1 * * - Monthly on the 1st at midnight

  • */15 * * * * - Every 15 minutes

Optional Arguments

• prompt - (Optional) The prompt to send to the agent when executing.

• enabled - (Optional) Whether the scheduled task is enabled. Defaults to true.

• notification - (Optional) Configuration for task notifications.

  • method - The notification method. Values: "Slack", "Teams", "Email".

  • destination - The destination for notifications.

  • team_name - Required for Teams notifications, the team name.

Attribute Reference

In addition to the arguments above, the following attributes are exported:

• id - The ID of the scheduled task.

• last_run - The timestamp of the last execution.

• next_run - The timestamp of the next scheduled execution.

• status - The current status of the scheduled task.

Import

Scheduled tasks can be imported using the id:

$ terraform import kubiya_scheduled_task.example TASK_ID