Manual Operating Hours

Manage the manually entered operating hours value stored per equipment, in minutes.

Base URL:

https://integration-api.ram.syniotec.com/master-data/v1/equipment-telemetry

Available Operations

  • POST /equipments/manual-operating-hours/list - Get manual operating hours list — View details
  • GET /equipments/{equipmentId}/manual-operating-hours - Get manual operating hours by equipment ID — View details
  • PUT /equipments/{equipmentId}/manual-operating-hours - Create or update manual operating hours — View details

Data Models & Schemas

ManualOperatingHours Entity

{
  "equipmentId": "uuid",
  "minutes": "number",
  "updatedBy": "uuid",
  "createdAt": "date-time",
  "updatedAt": "date-time"
}

Field Descriptions:

  • equipmentId - A unique identifier (UUID) for the equipment the value belongs to. Always present in the response. The equipment must already be known to the platform; unknown equipment is rejected with 404 EQUIPMENT_NOT_FOUND on the single-equipment operations
  • minutes - The manually entered operating hours value, expressed in minutes. Range 060000000, with a maximum of 2 decimal places. This is a metadata-only field: it is never summed with the calculated operating hours total and is never used in aggregations, reports, or triggers. Can be null — null means the value was never set or has been cleared (there is no separate "exists" flag)
  • updatedBy - A reference to the author of the last write (e.g. user ID). Can be null. It is overwritten on every write, so omitting it on a later update clears the previously stored author
  • createdAt - Timestamp of create, formatted in ISO 8601 standard (UTC).
  • updatedAt - Timestamp of the last write, formatted in ISO 8601 standard (UTC).

Error Response DTO

Standard error response format.

{
  "status": "number",
  "message": "string"
}

Field Descriptions:

  • status - HTTP status code (400-503)
  • message - Human-readable error message