Time Tracking Endpoints - Ever Gauzy™ Platform

Time Logs

List Time Logs

GET /api/timesheet/time-log?startDate=2024-01-01&endDate=2024-01-31
Authorization: Bearer {token}

Response (200 OK):

{
  "items": [
    {
      "id": "...",
      "startedAt": "2024-01-15T09:00:00.000Z",
      "stoppedAt": "2024-01-15T17:00:00.000Z",
      "duration": 28800,
      "logType": "TRACKED",
      "source": "DESKTOP",
      "description": "Working on feature X",
      "employeeId": "...",
      "projectId": "...",
      "taskId": "...",
      "organizationId": "..."
    }
  ],
  "total": 150
}

Create Time Log

POST /api/timesheet/time-log
Authorization: Bearer {token}
Content-Type: application/json

{
  "startedAt": "2024-01-15T09:00:00.000Z",
  "stoppedAt": "2024-01-15T17:00:00.000Z",
  "logType": "MANUAL",
  "source": "WEB_TIMER",
  "description": "Working on feature X",
  "projectId": "project-uuid",
  "taskId": "task-uuid",
  "organizationId": "org-uuid",
  "isBillable": true
}

Update Time Log

PUT /api/timesheet/time-log/{id}
Authorization: Bearer {token}
Content-Type: application/json

{
  "stoppedAt": "2024-01-15T18:00:00.000Z",
  "description": "Updated description"
}

Delete Time Log

DELETE /api/timesheet/time-log/{id}
Authorization: Bearer {token}

Log Types

Type	Description	Source
`TRACKED`	Tracked by desktop timer	Desktop Timer app
`MANUAL`	Manually entered	Web UI or API
`IDLE`	Idle time (automatically detected)	Desktop Timer
`RESUMED`	Resumed from idle	Desktop Timer

Log Sources

Source	Description
`WEB_TIMER`	Browser-based timer
`DESKTOP`	Desktop Timer app
`MOBILE`	Mobile app
`BROWSER_EXTENSION`	Browser extension
`HUBSTAFF`	HubStaff integration
`UPWORK`	Upwork integration

Timesheets

List Timesheets

GET /api/timesheet?startDate=2024-01-01&endDate=2024-01-31
Authorization: Bearer {token}

Submit Timesheet

PUT /api/timesheet/submit
Authorization: Bearer {token}
Content-Type: application/json

{
  "ids": ["timesheet-uuid-1", "timesheet-uuid-2"],
  "status": "PENDING"
}

Approve Timesheet

PUT /api/timesheet/approve
Authorization: Bearer {token}
Content-Type: application/json

{
  "ids": ["timesheet-uuid-1"]
}

Deny Timesheet

PUT /api/timesheet/deny
Authorization: Bearer {token}
Content-Type: application/json

{
  "ids": ["timesheet-uuid-1"]
}

Timesheet Statuses

Status	Description
`DRAFT`	Not yet submitted
`PENDING`	Submitted, awaiting approval
`IN_REVIEW`	Under review
`APPROVED`	Approved by manager
`DENIED`	Rejected by manager

Activity & Screenshots

Get Activities

GET /api/timesheet/activity?startDate=2024-01-01&endDate=2024-01-31&employeeId={id}
Authorization: Bearer {token}

Get Screenshots

GET /api/timesheet/screenshot?startDate=2024-01-01&endDate=2024-01-31
Authorization: Bearer {token}

Response:

{
  "items": [
    {
      "id": "...",
      "file": "https://storage.example.com/screenshots/uuid.png",
      "thumb": "https://storage.example.com/screenshots/uuid-thumb.png",
      "recordedAt": "2024-01-15T10:30:00.000Z",
      "timeSlotId": "...",
      "employeeId": "..."
    }
  ]
}

Statistics

Get Time Summary

GET /api/timesheet/statistics/counts?startDate=2024-01-01&endDate=2024-01-31
Authorization: Bearer {token}

Response:

{
  "weeklyDuration": 144000,
  "weeklyActivities": 85,
  "todayDuration": 28800,
  "todayActivities": 12
}

Get Project Time Report

GET /api/timesheet/time-log/report/daily-chart?startDate=2024-01-01&endDate=2024-01-31&groupBy=project
Authorization: Bearer {token}

Timer

Start Timer

POST /api/timesheet/timer/start
Authorization: Bearer {token}
Content-Type: application/json

{
  "projectId": "project-uuid",
  "taskId": "task-uuid",
  "organizationId": "org-uuid",
  "description": "Working on feature"
}

Stop Timer

POST /api/timesheet/timer/stop
Authorization: Bearer {token}
Content-Type: application/json

{
  "organizationId": "org-uuid"
}

Toggle Timer

POST /api/timesheet/timer/toggle
Authorization: Bearer {token}
Content-Type: application/json

{
  "projectId": "project-uuid",
  "taskId": "task-uuid",
  "organizationId": "org-uuid"
}

Required Permissions

Endpoint	Permission
`GET /api/timesheet/time-log`	`TIME_TRACKER`
`POST /api/timesheet/time-log`	`TIME_TRACKER`
`PUT /api/timesheet/approve`	`CAN_APPROVE_TIMESHEET`
`GET /api/timesheet/screenshot`	`TIME_TRACKER`