Daily logs

Every day a crew works a visit has a daily log: its sign-off status and notes, plus the daily reports the crew filed from the TruTec crew app (weather, work performed, delays, safety, materials, equipment and quantity completed). Time punches for the day are time entries.

When the workspace uses daily log sign-off, a day moves draft → submitted (the foreman submits) → office_approved → payroll_approved (only when payroll gives a second sign-off). Office approval approves the day's time for payroll.

Writes act as the person who created the API key; they must be an office user (not a crew login). A day payroll has approved can't be changed until a payroll approver sends it back (409).

The daily log object#

Field	Type	Description
id	integer
work_order_id, job_id	integer	The visit and job.
date	string	The work day.
status	string	draft, submitted, office_approved or payroll_approved.
notes	string or null	Day notes from the foreman or office.
submitted_at, submitted_by		When and who submitted.
office_approved_at, office_approved_by, payroll_approved_at, payroll_approved_by		Sign-offs.
returned_at, return_note		The last send-back and why.
daily_reports	array	The crew's reports for that visit and day (single-log reads only).
created_at, updated_at	string	UTC.

Daily logs#

List daily logs#

GET /v1/daily-logs

Permission: Read jobs

Newest day first. With updated_after, sorted by updated_at, oldest first.

Name	Type	Required	Description
start_date, end_date	string	No	Work days.
job_id, work_order_id	integer	No
status	string	No	One of the statuses above.
updated_after	string	No	ISO 8601.
limit, offset	integer	No	Default 50, maximum 200.

curl "https://trutec.ai/api/v1/daily-logs?status=submitted" \
  -H "X-API-Key: sk_your_api_key_here"

{
  "data": [
    {
      "id": 9120,
      "work_order_id": 4120,
      "job_id": 70412,
      "date": "2026-11-03",
      "status": "submitted",
      "notes": "Rain delay until 10am",
      "submitted_at": "2026-11-03T23:41:09Z",
      "submitted_by": { "id": 344, "name": "Crew Lead" },
      "office_approved_at": null,
      "office_approved_by": null,
      "payroll_approved_at": null,
      "payroll_approved_by": null,
      "returned_at": null,
      "return_note": null,
      "created_at": "2026-11-03T13:02:44Z",
      "updated_at": "2026-11-03T23:41:09Z"
    }
  ],
  "pagination": { "total": 1, "limit": 50, "offset": 0 }
}

Get a daily log#

GET /v1/daily-logs/{id}

Permission: Read jobs

The log with the day's daily_reports.

Add office notes to a day#

POST /v1/daily-logs

Permission: Write jobs

Saves the office's notes on a visit's day, creating that day's log if it has none yet. Returns 200 with the log.

Name	Type	Required	Description
work_order_id	integer	Yes
date	string	Yes	The work day.
notes	string	Yes	Replaces the day's notes.

curl -X POST "https://trutec.ai/api/v1/daily-logs" \
  -H "X-API-Key: sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "work_order_id": 4120, "date": "2026-11-03", "notes": "Rain delay until 10am" }'

Approve a day, or send it back#

POST /v1/daily-logs/{id}/approve

POST /v1/daily-logs/{id}/send-back with {"note": "Missing the second truck"}

Permission: Write jobs

Approve signs off a submitted day as the office (or as payroll, for an office-approved day when the key's creator is a payroll approver). Send back returns the day to the foreman as a draft with your note. When the workspace does not use sign-off, both return 409.

Crew daily reports#

List daily reports#

GET /v1/daily-reports

Permission: Read jobs

Takes job_id, work_order_id, start_date, end_date, limit and offset. Newest first.

{
  "data": [
    {
      "id": 66120,
      "job_id": 70412,
      "work_order_id": 4120,
      "estimate_service_id": 55120,
      "date": "2026-11-03",
      "submitted_by": { "id": 344, "name": "Crew Lead" },
      "weather": "Overcast, 58°F",
      "work_performed": "Cleaned and crack-filled the east lot; first coat down.",
      "delay_notes": "Rain until 10am",
      "safety_notes": null,
      "material_notes": "Used 600 gal sealer",
      "equipment_notes": null,
      "completed_quantity": 21000.0,
      "completed_unit": "SF",
      "answers": { "Was the site clear when you arrived?": "Yes" },
      "photo_count": 6,
      "created_at": "2026-11-03T23:40:51Z"
    }
  ],
  "pagination": { "total": 1, "limit": 50, "offset": 0 }
}

answers holds the workspace's own daily-report questions. Photos are counted here; read them with the job's photos endpoints.

Get a daily report#

GET /v1/daily-reports/{id}

Permission: Read jobs

Daily reports are filed from the crew app; the API reads them and can email them.

Email a daily report#

POST /v1/daily-reports/{id}/send

Permission: Write jobs

Sends the report's summary (weather, work performed, production, delays, safety, materials and equipment) to one address, such as the customer or the general contractor, like Email report in TruTec.

Field	Type	Required	Description
to_email	string	Yes	One email address.

curl -X POST "https://trutec.ai/api/v1/daily-reports/66120/send" \
  -H "X-API-Key: sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "to_email": "[email protected]" }'

Returns the report as data and emailed_to. When the email can't be sent (for example the key creator has no connected mailbox), the response is 502 and nothing is recorded as sent.