Skip to main content

Maintenance Events

Schedule, track, and manage maintenance events for your machines.

Create a maintenance event​

POST /maintenance

Auth: Bearer JWT (admin, operator)

curl -X POST https://api.haltless.io/api/v1/maintenance \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "machine_id": "MACHINE_UUID",
    "title": "Quarterly bearing inspection",
    "description": "Check and replace main spindle bearings if needed",
    "scheduled_start": "2026-04-10T08:00:00Z",
    "scheduled_end": "2026-04-10T12:00:00Z",
    "type": "preventive"
  }'

List maintenance events​

GET /maintenance

Auth: Bearer JWT (any role)

ParameterTypeDescription
machine_iduuidFilter by machine
statusstringFilter by status
start_afterdatetimeEvents starting after this date
end_beforedatetimeEvents ending before this date

Get a maintenance event​

GET /maintenance/{event_id}

Update a maintenance event​

PUT /maintenance/{event_id}

Auth: Bearer JWT (admin, operator)

Delete a maintenance event​

DELETE /maintenance/{event_id}

Auth: Bearer JWT (admin, operator)