TimeBlock

{
  "$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"]
}