Stage

Represents a defined execution step within a production Run.

For example, filling, capping, labelling, and case packing can each be recorded as a separate Stage within the same Run.

A Stage records when that part of the Run was active and which Machine performed the step.

The Stage object

{
  "run": "L01-260810-002",
  "stage": "fill",
  "machine": "EQ010",
  "start": "2026-08-10T22:10:00+02:00",
  "end": "2026-08-11T05:50:00+02:00"
}

Fields

Stage identity

A Stage is identified within its Run by the combination of run and stage.

For example:

L01-260810-002/fill

and:

L01-260810-003/fill

represent different Stage executions even though both use the fill Stage code.

Stage status

A Stage without end remains open.

When end is supplied, the Stage is treated as completed.

end = null    → running
end supplied  → completed

Stages and machines

The Machine is associated with the Stage during which it operates rather than with the entire Run.

For example:

Run
├── fill   → EQ010
├── cap    → EQ020
├── label  → EQ030
└── case   → EQ040

This allows Pulse to preserve the actual operating period of each Machine.

A production Run may last eight hours while a particular Machine operates for only part of that time. Recording the Machine on the Stage preserves that distinction.

Reference protection

A Run or Machine referenced by an existing Stage cannot be deleted until the Stage reference is removed.

API resource

Resource	Base path
Stage	/manufacturing/food-beverage/v1/stages

API methods

Create a stage

POST /manufacturing/food-beverage/v1/stages/insert

Creates a Stage within a production Run.

Request

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

{
  "run": "L01-260810-002",
  "stage": "fill",
  "machine": "EQ010",
  "start": "2026-08-10T22:10:00+02:00",
  "end": "2026-08-11T05:50:00+02:00"
}

Parameters

Parameter	Type	Required	Description
run	string	yes	Business code of the production Run.
stage	string	yes	Stage code within the Run.
machine	string	yes	Business code of the Machine performing the Stage.
start	string	yes	Date and time when the Stage started.
end	string or null	no	Date and time when the Stage ended.

Update a stage

PUT /manufacturing/food-beverage/v1/stages/update

Updates an existing Stage.

The Stage is identified by the combination of run and stage.

Request

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

{
  "run": "L01-260810-002",
  "stage": "fill",
  "machine": "EQ010",
  "start": "2026-08-10T22:10:00+02:00",
  "end": "2026-08-11T06:00:00+02:00"
}

Patch a stage

PATCH /manufacturing/food-beverage/v1/stages/patch

Partially updates an existing Stage.

The Stage is identified by properties.run and properties.stage. Fields omitted from properties keep their current values.

end can be explicitly cleared by including it with a null value.

Request

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

{
  "properties": {
    "run": "L01-260810-002",
    "stage": "fill",
    "end": "2026-08-11T06:00:00+02:00"
  }
}

Parameters

Parameter	Type	Required	Description
properties	object	yes	Fields included in the partial update.
properties.run	string	yes	Business code of the Run containing the Stage.
properties.stage	string	yes	Stage code identifying the Stage within the Run.
properties.machine	string	no	New Machine business code.
properties.start	string	no	New Stage start date and time.
properties.end	string or null	no	New Stage end date and time, or null to leave the Stage open.

Retrieve a stage

GET /manufacturing/food-beverage/v1/stages/select

Returns the Stage identified by its Run and Stage code.

Request

GET /manufacturing/food-beverage/v1/stages/select?run=L01-260810-002&stage=fill

Query parameters

Parameter	Type	Required	Description
run	string	yes	Business code of the production Run.
stage	string	yes	Stage code within the Run.

List stages

GET /manufacturing/food-beverage/v1/stages/query

Returns Stages matching the supplied filters.

Request

GET /manufacturing/food-beverage/v1/stages/query?runs=L01-260810-002&machines=EQ010

Query parameters

Parameter	Type	Required	Description
runs	string or array of strings	no	Limits results to Stages belonging to the specified Runs.
stages	string or array of strings	no	Limits results to the specified Stage codes.
machines	string or array of strings	no	Limits results to Stages performed by the specified Machines.
from	string	no	Limits results to Stages starting at or after the specified date and time.
to	string	no	Limits results to Stages starting at or before the specified date and time.

Multiple values can be supplied by repeating the query parameter:

GET /manufacturing/food-beverage/v1/stages/query?stages=fill&stages=cap

Delete a stage

DELETE /manufacturing/food-beverage/v1/stages/delete

Deletes the Stage identified by its Run and Stage code.

Request

DELETE /manufacturing/food-beverage/v1/stages/delete?run=L01-260810-002&stage=fill

Query parameters

Parameter	Type	Required	Description
run	string	yes	Business code of the production Run.
stage	string	yes	Stage code within the Run.