Set a maintenance schedule
set_maintenance_scheduleDestructiveIdempotent
Set the user's own schedule for one maintenance task on one grinder or machine: their own interval, switching it off, or muting the reminder until a date. Only the keys you send in fields change; send every: null to go back to the maker's guidance and muted_until: null to unmute. Use it when the user states how often they do a task or asks to be left alone about one, never to invent an interval. The task's class, interval and due state are read back from list_grinders and list_machines.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | The task, as its value in that equipment's maintenance.tasks | |
| fields | No | ||
| changed_at | No | Optional: when the user made this change (ISO 8601, UTC). An app sending a queued edit passes it, so an older edit never overwrites a newer one; it is then answered with applied: false | |
| equipment_id | Yes | This account's own grinder or machine number, from list_grinders or list_machines | |
| equipment_kind | Yes | Which kind of equipment the task is on |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| due | Yes | ||
| task | Yes | ||
| class | Yes | ||
| every | Yes | ||
| applied | Yes | ||
| message | Yes | ||
| schedule | Yes | ||
| equipment_id | Yes | ||
| every_source | Yes | ||
| equipment_kind | Yes |