Sign in

v1

latestOpenAPI 3.0.32026-08-0613775357.6 KB
time entries

Create user time entry

Creates a new time entry for a user. The user_id in the URL must match the user_id in the request body if it's supplied.

Note: When creating time entries, a valid user_id, assignable_id, date and hours must be supplied. Assignable ID can be assignable_id, project_id or leave_type_id.

You can optionally specify values for task and notes, which must be fewer than 256 characters in length. If you know a valid bill_rate_id matching the user and project of the time entry, you can specify that at the time of creating a time entry as well.

post/users/{user_id}/time_entries

Path parameters

user_idinteger required

The ID of the user.

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 created 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"
}