OneTake Docs

Edit a Schedule

Change a service schedule's task name, cadence, category, and lead time from the gear item's service tab.

You can edit any active service schedule directly from the gear item's service tab. Changes take effect immediately.

Fields

Name

The task name shown on the schedule card. Required.

Category

A single-select dropdown built from the same canonical category list used throughout the app. Use this to associate the schedule with a gear category other than — or instead of — what the item or its built-in template implies.

Select No category to leave the schedule without a category mapping.

The dropdown contains every canonical equipment category — see Equipment categories for the full list.

When a category is set on the schedule, it takes priority over the item's own category and the built-in template's category for purposes like the card icon.

Cadence

How often the task repeats. Enter a number and choose a unit:

UnitDays used
days1
weeks7
months30
years365

Changing the cadence automatically adjusts the schedule's next due date.

Lead time (days)

How many days before the due date you want a reminder. Leave blank to use the automatic lead time derived from the cadence.

Saving

The dialog saves all fields together when you select Save. Each field is validated before the save is attempted:

  • Name must not be blank after trimming.
  • Category must be a canonical value from the list, or cleared (No category). An off-vocabulary value is rejected with an error.
  • Cadence must be a positive integer number of days.
  • Lead time, when provided, must be zero or more whole days.

If the category is omitted entirely from the save payload, the stored category is left unchanged. This only matters for programmatic use — the dialog always sends the current dropdown value.

Audit log

Every successful edit is recorded in the studio's audit log as a maintenance.schedule_updated event. The entry includes the schedule ID, the before and after values of the task name and cadence, and — when the category was changed — the before and after values of the category.

On this page