---
title: "Scheduling Agents from Catalog"
---

# Scheduling Agents from Catalog

## Overview

By exposing the ability to schedule an Agent from the Catalog, users can schedule deployed agents to run automatically at specified times and frequencies. Users can create one-time or recurring schedules with custom prompts, and admins can manage (pause, resume, delete) any user's schedules.

---

## User Flow

### Creating a Schedule

1. User navigates to the desired Agent from catalog or opens an Agent to chat
2. Clicks "Schedule Agent"
3. The Schedule Agent modal opens with the following fields:
   - **Schedule Name** (optional, 3+ chars if provided) - used to distinguish multiple schedules
   - **Start Date** (required for one-time) - date picker, past dates disabled
   - **Start Time** (required) - 15-minute intervals, 24-hour format
   - **Recurrence** - None (one-time), Daily, Weekly, or Monthly
   - **User Input** (required, 3+ chars, max 4000) - the prompt sent to the agent on each run
4. User clicks "Save"
5. Schedule is created immediately

### Viewing Schedules

Users can view their schedules for a deployment by clicking the schedule dropdown on the deployment card. Each entry shows the schedule name and pause status. Users can also navigate to the Catalog and use the "Scheduled" quick filter to find all agents with a schedule.

### Editing a Schedule

1. User clicks a schedule from the list
2. Dialog opens in view-only mode
3. User clicks "Edit" to enable editing
4. User modifies fields (same validations apply)
5. User clicks "Save" - the existing job is cancelled and a new one is published

### Deleting a Schedule

1. User clicks "Delete" in the schedule details dialog
2. Confirmation dialog appears
3. On confirm, the scheduled job is cancelled and the record is deleted

---

## Schedule Types

| Type | Description |
|------|-------------|
| `OneTime` | Runs once at a specific date/time |
| `Daily` | Runs every day at the specified time |
| `Weekly` | Runs on selected days of the week at the specified time |
| `Monthly` | Runs monthly at the specified time |

---

## Admin Capabilities

Admins and project admins have additional controls beyond what end users can do. While users can only manage their own schedules, admins have full visibility and control over all user-created schedules.

### Finding Agents with Schedules

1. Navigate to the **Agents** page (`/agents/all`)
2. A **"Scheduled"** column appears in the agents table showing a calendar badge for any agent that has user schedules
3. Admins can also use the **header filter** on the Scheduled column to quickly filter down to only agents with active schedules

### Managing User Schedules

1. Click the **calendar badge** on an agent row — this opens the Agent Settings dialog directly to the **Interfaces** tab with the schedule management view
2. The schedule management view displays a table of all user schedules for that agent, showing:
   - **Owner name** — the user who created the schedule
   - **Agent action** — the prompt/instructions the user configured
   - **Status** — Active or Paused
3. Use the **search bar** to filter schedules by username, email, or prompt content

### Pausing a Schedule

1. Click the **actions menu** (three dots) on a schedule row and select **Pause**, or select multiple schedules using the checkboxes and click the **Pause** bulk action button
2. A confirmation dialog appears — click **Pause** to confirm
3. The schedule is paused and the owner receives a notification

### Resuming a Schedule

1. Click the **actions menu** on a paused schedule row and select **Resume**
2. The schedule resumes immediately — no confirmation required

### Deleting a Schedule

1. Click the **actions menu** on a schedule row and select **Delete**, or select multiple schedules and click the **Delete** bulk action button
2. A confirmation dialog appears — click **Delete** to confirm
3. The schedule is removed and the owner receives a notification

---

## Notifications

Owners of a schedule will be alerted when administrators make changes.

| Event | Recipient |
|-------|-----------|
| Admin pauses a schedule | Schedule owner |
| Admin deletes a schedule | Schedule owner |
| User access revoked from deployment | Schedule owner (for each affected schedule) |

---

## Enabling or Disabling Scheduling

Platform Admins and Security Admins can control whether users have the ability to schedule agents from the Catalog.

1. Navigate to **Settings > Account** (`/settings/account`)
2. Find the **Permissions** section, which displays a grid of permission cards
3. Click the **End User Scheduling** card (shown with a calendar icon)
4. A modal opens with the following options:
   - **Allow all users** — toggle this on to enable scheduling for everyone
   - **Specific users or groups** — toggle off "Allow all users" and then select individual users or groups who should have access
   - To **completely disable** scheduling, toggle off "Allow all users" and leave the user/group selection empty
5. Click **Save** to apply the changes

Read-Only Admins can view the current permission settings but cannot make changes.

---

## Audit Logs

The following scheduling events produce audit log entries:

| Event | Triggered By |
|-------|-------------|
| User creates a schedule | End user |
| User updates a schedule | End user |
| User deletes a schedule | End user |
| Admin pauses a schedule | Admin / Project Admin |
| Admin resumes a schedule | Admin / Project Admin |
| Admin deletes a schedule | Admin / Project Admin |
