Time Entries

Time entries let your team log hours against projects. Track billable vs. non-billable time, see per-project summaries, and know where your team’s effort is going.

The Time Entry Object

Field	Type	Description
id	uuid	Unique identifier for the time entry
project_id	uuid	ID of the project the time was logged against
account_id	uuid	ID of the account that owns the time entry
user_id	uuid	ID of the user who logged the time
date	string	Date the work was performed in ISO 8601 (YYYY-MM-DD) format
duration_minutes	int	Duration of the logged work in minutes
description	string	Description of the work performed
billable	bool	Whether this time is billable to the client; defaults to true
created_at	datetime	Timestamp the time entry was created, ISO 8601
updated_at	datetime	Timestamp the time entry was last updated, ISO 8601
user_name	string	Name of the user who logged the time (read-only, populated via join)

Log a time entry

Endpoint: time-entries-create

Field	Type	Required	Description
project_id	string	Yes	ID of the project to log time against
date	string	No	Date the work was performed in ISO 8601 (YYYY-MM-DD) format; defaults to today if omitted
duration_minutes	int	Yes	Duration of the work in minutes; must be greater than 0
description	string	No	Description of the work performed
billable	bool?	No	Whether this time is billable to the client; defaults to true when omitted

curl -X POST https://api.driftwoodapp.com/api/time-entries-create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"project_id": "...", "duration_minutes": 0}'

Delete a time entry

Endpoint: time-entries-delete

Field	Type	Required	Description
id	string	Yes	ID of the time entry to delete

curl -X POST https://api.driftwoodapp.com/api/time-entries-delete \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "..."}'

List time entries for a project

Endpoint: time-entries-list

Field	Type	Required	Description
project_id	string	Yes	ID of the project whose time entries to list

curl -X POST https://api.driftwoodapp.com/api/time-entries-list \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"project_id": "..."}'

Get time entry summary for a project

Endpoint: time-entries-summary

Field	Type	Required	Description
project_id	string	Yes	ID of the project to summarize logged time for

curl -X POST https://api.driftwoodapp.com/api/time-entries-summary \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"project_id": "..."}'

Update a time entry

Endpoint: time-entries-update

Field	Type	Required	Description
id	string	Yes	ID of the time entry to update
date	string	No	Updated work date in ISO 8601 (YYYY-MM-DD) format; ignored if empty
duration_minutes	int?	No	Updated duration in minutes
description	string?	No	Updated description of the work performed
billable	bool?	No	Whether this time is billable to the client

curl -X POST https://api.driftwoodapp.com/api/time-entries-update \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "..."}'

Error Codes

Code	Description
time_entries.invalid_project_id	Invalid project id
time_entries.duration_required	Duration required
time_entries.invalid_id	Invalid id
time_entries.not_found	Not found