Timer

Partially update a timer

Changed on
patch/api/timers/{timerId}

Request

  • Base URL
    https://api.fulcrumpro.com
  • URL
    https://api.fulcrumpro.com/api/timers/{timerId}
  • Auth
    none declared

Path parameters

timerIdstring required

Request body

opstring
valueunknown
pathstring
fromstring

Source path — present for move/copy operations, absent otherwise.

Response

Timer

idstring required

The timer identifier

jobIdstring nullable

The job identifier

jobNamestring nullable

The job name.

itemToMakeIdstring nullable

The item to make identifier

itemToMakeItemIdstring nullable

The item to make's original item id.

itemToMakeNamestring nullable

The item to make name.

itemToMakeDescriptionstring nullable

The item to make description.

jobOperationIdstring nullable

The job operation identifier

jobOperationNamestring nullable

The job operation name.

jobOperationDescriptionstring nullable

The job operation description.

jobOperationSystemOperationIdstring nullable

The identifier of the system operation the job operation was created from. Populated only by the list endpoints: null when the timer has no job operation or the job operation has no system operation, and always null in the create, update and patch responses.

workOrderIdstring nullable

The work order identifier. Set when the timer is tracked against a work order rather than a job.

workOrderNamestring nullable

The work order name (its number when unnamed).

workOrderOperationIdstring nullable

The work order operation identifier.

workOrderOperationNamestring nullable

The work order operation name.

startedByIdstring nullable

The user identifier who started the timer

startedOnUtcstring date-time required

When the timer was started in UTC time.

startedOnUtcOriginalstring date-time required

When the timer was ORIGINALLY started in UTC time.

stoppedOnUtcstring date-time nullable

When the timer was stopped in UTC time.

stoppedOnUtcOriginalstring date-time nullable

When the timer was ORIGINALLY stopped in UTC time.

type'setup' | 'run' | 'clockIn' | 'break' | 'labor' | 'machine' required
isRunningboolean

Whether the timer is running or not

createdUtcstring date-time required

When the timer was created in UTC time.

modifiedUtcstring date-time nullable

When the timer was modified in UTC time.

elapsedTimeInSecondsnumber double nullable

Elapsed time this timer was running. Can be greater than the labor time if the operator has multiple concurrent timers.

operationTimeInSecondsnumber double nullable

Total Operation run time If this timer was overridden, the operation time will be adjusted by the multiple of the adjustment

laborTimeInSecondsnumber double nullable

Labor time for use in costing calculations Can be less than elapsed time if an operator's time was split between jobs

machineTimeInSecondsnumber double nullable

Machine time for use in costing and time displays which is just the elapsed time of the segments If the start/stop time has been overridden directly, use that value

externalReferencesobject nullable

External references associated with this entity.

Changes

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: application/problem+json)

    • breaking

      the / request property type changed from string to no type

    • info

      added the new optional request property /