Line time

Records intervals when a production line was in a declared non-running or constrained condition.

For example, if a line stops for 20 minutes because of a breakdown or waits for material before production can continue, that interval can be recorded as line time.

Line time is used to account for production losses such as breakdowns, micro-stops, waiting, and other non-running conditions.

The Line time object

{
  "line": "LINE001",
  "condition": "breakdown",
  "reason": "DTCU010",
  "toldBy": "equipment",
  "from": "2026-08-11T03:40:00+02:00",
  "to": "2026-08-11T04:05:00+02:00"
}

Fields

Running time

The productive running condition is not recorded explicitly.

For example:

Only the breakdown interval is submitted.

When Line time is queried for a bounded time window and running is requested, Pulse can derive the productive intervals from gaps between the explicitly recorded conditions.

For example:

GET /manufacturing/food-beverage/v1/line-time/query?lines=LINE001&conditions=running&from=2026-08-10T22:00:00%2B02:00&to=2026-08-11T00:00:00%2B02:00

may return the two running intervals surrounding the recorded breakdown.

Derived running intervals have:

{
  "condition": "running",
  "reason": null,
  "toldBy": "equipment"
}

Open intervals

An interval can be submitted before its end time is known:

{
  "line": "LINE001",
  "condition": "breakdown",
  "reason": "DTCU010",
  "toldBy": "equipment",
  "from": "2026-08-11T03:40:00+02:00"
}

When the condition ends, the existing interval can be corrected by submitting the same line, condition, and from with to:

{
  "line": "LINE001",
  "condition": "breakdown",
  "reason": "DTCU010",
  "toldBy": "equipment",
  "from": "2026-08-11T03:40:00+02:00",
  "to": "2026-08-11T04:05:00+02:00"
}

to = null    → open
to supplied  → closed

Condition identity and corrections

A Line time interval is identified by:

line + condition + from

For example:

LINE001 / breakdown / 2026-08-11T03:40:00+02:00

Submitting insert again with the same composite key updates the existing interval rather than creating another one.

This allows source systems to resend an interval later when its end time or other details become known.

Source of the condition

toldBy records how the condition was identified.

Value	Meaning
equipment	The condition was reported automatically by equipment or another production system.
operator	The condition was declared manually by an operator.

Reasons

reason can provide additional context for the condition.

When the source system has a registered Reason code, use that code:

{
  "condition": "breakdown",
  "reason": "DTCU010"
}

Free text may also be supplied when no registered Reason exists.

Using registered Reason codes provides more consistent grouping and analysis.

API resource

Resource	Base path
Line time	/manufacturing/food-beverage/v1/line-time

API methods

Submit line time

POST /manufacturing/food-beverage/v1/line-time/insert

Records one non-running or constrained Line time interval.

If an interval with the same line, condition, and from already exists, the existing interval is updated.

Request

POST /manufacturing/food-beverage/v1/line-time/insert
Content-Type: application/json

{
  "line": "LINE001",
  "condition": "breakdown",
  "reason": "DTCU010",
  "toldBy": "equipment",
  "from": "2026-08-11T03:40:00+02:00",
  "to": "2026-08-11T04:05:00+02:00"
}

Parameters

Parameter	Type	Required	Description
line	string	yes	Business code of the Production line.
condition	string	yes	Registered line-condition code. running is not accepted.
reason	string or null	no	Registered Reason code or free-text explanation.
toldBy	string	yes	equipment or operator.
from	string	yes	Date and time when the interval started.
to	string or null	no	Date and time when the interval ended.

Update line time

PUT /manufacturing/food-beverage/v1/line-time/update

Updates the Line time interval identified by line, condition, and from.

Request

PUT /manufacturing/food-beverage/v1/line-time/update
Content-Type: application/json

{
  "line": "LINE001",
  "condition": "breakdown",
  "reason": "DTCU010",
  "toldBy": "equipment",
  "from": "2026-08-11T03:40:00+02:00",
  "to": "2026-08-11T04:10:00+02:00"
}

Patch line time

PATCH /manufacturing/food-beverage/v1/line-time/patch

Partially updates an existing Line time interval.

The interval is identified by properties.line, properties.condition, and properties.from. All three are required.

reason and to can be explicitly cleared by including them with a null value.

Request

PATCH /manufacturing/food-beverage/v1/line-time/patch
Content-Type: application/json

{
  "properties": {
    "line": "LINE001",
    "condition": "breakdown",
    "from": "2026-08-11T03:40:00+02:00",
    "to": "2026-08-11T04:10:00+02:00"
  }
}

Parameters

Parameter	Type	Required	Description
properties	object	yes	Fields included in the partial update.
properties.line	string	yes	Production-line business code identifying the interval.
properties.condition	string	yes	Condition code identifying the interval.
properties.from	string	yes	Start time identifying the interval.
properties.reason	string or null	no	New Reason or free-text explanation, or null to clear it.
properties.toldBy	string	no	New reporter: equipment or operator.
properties.to	string or null	no	New end time, or null to leave the interval open.

Retrieve line time

GET /manufacturing/food-beverage/v1/line-time/select

Returns the Line time interval identified by its composite business key.

Request

GET /manufacturing/food-beverage/v1/line-time/select?line=LINE001&condition=breakdown&from=2026-08-11T03:40:00%2B02:00

Query parameters

Parameter	Type	Required	Description
line	string	yes	Business code of the Production line.
condition	string	yes	Condition code.
from	string	yes	Interval start date and time.

List line time

GET /manufacturing/food-beverage/v1/line-time/query

Returns Line time intervals matching the supplied filters.

Request

GET /manufacturing/food-beverage/v1/line-time/query?lines=LINE001&conditions=breakdown

Query parameters

Parameter	Type	Required	Description
lines	string or array of strings	no	Limits results to the specified Production lines.
conditions	string or array of strings	no	Limits results to the specified conditions.
reasons	string or array of strings	no	Limits results to the specified Reasons or reason strings.
toldBy	string or array of strings	no	Limits results to the specified reporters.
from	string	no	Beginning of the requested time window.
to	string	no	End of the requested time window.
open	boolean	no	true returns open intervals; false returns closed intervals.

Multiple values can be supplied by repeating the query parameter:

GET /manufacturing/food-beverage/v1/line-time/query?conditions=breakdown&conditions=micro-stop

Delete line time

DELETE /manufacturing/food-beverage/v1/line-time/delete

Deletes the Line time interval identified by its composite business key.

Request

DELETE /manufacturing/food-beverage/v1/line-time/delete?line=LINE001&condition=breakdown&from=2026-08-11T03:40:00%2B02:00

Query parameters

Parameter	Type	Required	Description
line	string	yes	Business code of the Production line.
condition	string	yes	Condition code.
from	string	yes	Interval start date and time.