TimeBlock

A reported or calculated time block representing hours worked

Absence ManagementAttendanceEnterpriseHCMHuman Capital ManagementPayrollSchedulingTime TrackingTimesheetsWorkforce Management

Properties

Name	Type	Description
id	string	Unique Workday ID of the time block
workerId	string	Workday ID of the worker
date	string	Date of the time block
startTime	string	Start time of the time block (HH:MM:SS)
endTime	string	End time of the time block (HH:MM:SS)
hours	number	Total hours in the time block
type	string	Type of time block
status	string	Status of the time block
projectId	string	Associated project ID (optional)
taskId	string	Associated task ID (optional)
comment	string	Optional comment for the time block
createdAt	string	Timestamp when the time block was created
modifiedAt	string	Timestamp when the time block was last modified

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/workday-tracking-system/refs/heads/main/json-schema/time-tracking-time-block-schema.json",
  "title": "TimeBlock",
  "description": "A reported or calculated time block representing hours worked",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique Workday ID of the time block",
      "example": "3c5c2e9cd6bd4a74b1a6b8c8e0a7f3d2"
    },
    "workerId": {
      "type": "string",
      "description": "Workday ID of the worker",
      "example": "e3f2a1b0c8d7e6f5"
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Date of the time block",
      "example": "2026-05-03"
    },
    "startTime": {
      "type": "string",
      "format": "time",
      "description": "Start time of the time block (HH:MM:SS)",
      "example": "09:00:00"
    },
    "endTime": {
      "type": "string",
      "format": "time",
      "description": "End time of the time block (HH:MM:SS)",
      "example": "17:00:00"
    },
    "hours": {
      "type": "number",
      "format": "float",
      "description": "Total hours in the time block",
      "example": 8.0
    },
    "type": {
      "type": "string",
      "description": "Type of time block",
      "enum": ["Regular", "Overtime", "Holiday", "Leave"],
      "example": "Regular"
    },
    "status": {
      "type": "string",
      "description": "Status of the time block",
      "enum": ["Reported", "Calculated", "Approved", "Rejected"],
      "example": "Approved"
    },
    "projectId": {
      "type": "string",
      "description": "Associated project ID (optional)",
      "example": "proj_abc123"
    },
    "taskId": {
      "type": "string",
      "description": "Associated task ID (optional)",
      "example": "task_xyz789"
    },
    "comment": {
      "type": "string",
      "description": "Optional comment for the time block",
      "example": "Working on Q2 planning"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the time block was created",
      "readOnly": true
    },
    "modifiedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the time block was last modified",
      "readOnly": true
    }
  },
  "required": ["workerId", "date", "hours", "type"]
}