v1

latestOpenAPI 3.0.32026-08-0613775357.6 KB
time entries

Update user time entry

Updates an existing time entry.

put/users/{user_id}/time_entries/{id}

Path parameters

user_idinteger required

The ID of the user.

idinteger required

The ID of the time entry.

Request body

user_idinteger required

User ID (licensed user only).

assignable_idinteger required

Project, Phase or Leave type ID.

datestring date required

The date.

hoursnumber required

Number of hours confirmed.

taskstring nullable

A task category.

notesstring nullable

A note.

bill_rate_idinteger nullable

The rate ID reference.

Example request

{
  "user_id": 123,
  "assignable_id": 1001,
  "date": "2012-01-21",
  "hours": 0.5,
  "task": "Travel",
  "notes": "Drive to Seattle, WA"
}

Response

The time entry was updated successfully.

idinteger

Unique identifier for the time entry.

user_idinteger required

The ID of the user (licensed user only) associated with the time entry.

assignable_idinteger required

The ID of the assigned Project, Phase, or Leave Type.

assignable_type'Project' | 'LeaveType'

The type of the assignable resource.

datestring date required

The date of the time entry.

hoursnumber float required

The number of hours confirmed. Can be null.

is_suggestionboolean

Indicates if the time entry is a suggestion.

scheduled_hoursnumber float nullable

The number of scheduled hours for the time entry.

taskstring nullable

The task category. Can be null.

notesstring nullable

Additional notes for the time entry. Can be null.

bill_ratenumber float nullable

The hourly rate for the time entered.

bill_rate_idinteger nullable

The ID of the billing rate.

created_atstring date-time

Timestamp when the time entry was created.

updated_atstring date-time

Timestamp when the time entry was last updated.

Example response

{
  "id": 100000,
  "user_id": 123,
  "assignable_id": 1001,
  "assignable_type": "Project",
  "date": "2024-09-12",
  "is_suggestion": true,
  "scheduled_hours": 8,
  "bill_rate": 150,
  "bill_rate_id": 4,
  "created_at": "2024-09-12T04:32:28Z",
  "updated_at": "2024-09-18T04:32:28Z"
}