Actions31
- Agent Actions
- Attachment Actions
- Comment Actions
- Config Actions
- Dartboard Actions
- Doc Actions
- Folder Actions
- Help Center Article Actions
- Skill Actions
- Task Actions
- View Actions
Task → Add Task Time Tracking
AI-generatedSummary
Adds a time tracking entry to an existing Dart task.
Inputs
- id (required) — The unique ID of the Dart task.
- user (required) — The name or email of the user to attribute the tracked time to; use null to attribute to the current user.
- startedAt (required) — The start timestamp for the time entry in ISO 8601 format.
- finishedAt (required) — The end timestamp for the time entry in ISO 8601 format; must be after startedAt.
- customPropertyName — The name of a time-tracking type custom property; defaults to the main time tracking property.
- requestOptions — Options for batching, SSL, proxy, and timeout.
Output shape
an updated task object with refreshed time tracking
The response represents the updated task resource.
Examples
Example 1: Record work for a specific task
Set ID to the target task, specify user email, and provide ISO 8601 start/finish times.
Example 2: Track time as the current user
Set ID, user to null, and provide start/finish timestamps.