Scheduled tasks

Schedules run an action automatically at a regular interval, so nobody has to remember it.

Where to find it

The Configuration → Schedules section: Open the schedules ↗.

---

Creating a schedule

Click New schedule

The form opens.

Name the task

For example General channel reset. The name is required.

Choose the action type

See the table below.

Set the frequency

Then save.

The action types

Type	Effect
Channel reset (nuke)	Clones the target channel, deletes the original, then posts a message in the new channel announcing the reset.
Full server backup	Creates a backup automatically. It includes members, roles, channels, emoji and stickers, but never messages.
Data export (Logs & Profiles)	Produces an export of the logs and profiles.

The target channel is required

A channel reset needs a destination channel. Kotbo refuses to save the task without one, and thread channels are not supported.

The channel ID changes

A reset does not empty the channel: it creates a copy and deletes the original. Any external setting pointing at the channel by its ID (a webhook, another bot, a Kotbo module’s configuration) has to be redone after every run.

The frequencies

• Hourly
• Daily at midnight
• Weekly (Sunday at midnight)
• Monthly (the 1st at midnight)
• Custom (Cron expression)

The cron expression follows the standard Unix format minute hour day month day-of-week. For example, 0 12 * * * fires the task every noon.

---

Managing the schedules

Each card recalls the frequency, the target channel and the last run (or Never).

Button	Effect
Run	Executes the task immediately, in the background, without waiting for the next slot.
Edit	Reopens the form.
Delete	Removes the schedule permanently.

A schedule can also be enabled or disabled without being deleted, which is handy to pause a task during an event.

Test before automating

Use Run once by hand to check what the task actually does, especially for a channel reset, which destroys the history.