Manually log a downtime event (optionally pre-categorised). Used to log a current stoppage before the watcher catches it.

Authorization

bearer

AuthorizationBearer <token>

In: header

Path Parameters

factoryId*string

Factory slug

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

machineId*string

Machine code (e.g. IDHC-007)

startedAt*string

When the stoppage started (ISO timestamp).

endedAt?string

When the stoppage ended. Omit for ongoing.

stateCode?string

State that tripped the event (IDLE / ALARM / OFF / SETUP).

reasonId?string

Optional reason to assign immediately — one-shot create+categorize.

notes?string

Response Body

curl -X POST "https://api.xentr.ai/api/factories/string/downtime/events" \  -H "Content-Type: application/json" \  -d '{    "machineId": "string",    "startedAt": "2026-04-23T01:30:00Z"  }'

Empty

Manually log a downtime event (optionally pre-categorised). Used to log a current stoppage before the watcher catches it.

Authorization

Path Parameters

Request Body

Response Body

201