Time Entries

Create a time entry

post/time-entries

Request

  • Base URL: https://www.ruddr.io/api/workspace
  • URL: https://www.ruddr.io/api/workspace/time-entries
  • Auth: HTTP bearer

Request body

typeId'project_time' | 'time_off' required

The type of the time entry.

statusId'not_submitted' | 'pending_approval' | 'approved' | 'rejected'

The approval status of the time entry. Defaults to not_submitted if not supplied.

datestring date required

The date of the time entry. Should be in the form YYYY-MM-DD.

minutesinteger nullable

The number of minutes for the time entry. Must be a whole number between 1 and 1440. Required unless both startTime and endTime are provided.

notesstring nullable

Notes for the time entry. May be required depending on the project configuration. Max 5000 characters.

startTimestring nullable

The local start time in HH:mm (24-hour) format. Used with endTime to calculate minutes when not provided.

endTimestring nullable

The local end time in HH:mm (24-hour) format. Must be after startTime when set.

memberIdstring required

The member ID (uuid) of the member for this time entry.

projectIdstring nullable

The project ID (uuid) of the project for the time entry. Required when typeId is project_time.

roleIdstring nullable

The role ID (uuid) of the project role for the time entry. May be required depending on the project configuration.

taskIdstring nullable

The task ID (uuid) of the project task for the time entry. May be required depending on the project configuration.

timeOffTypeIdstring nullable

The time off type ID (uuid) for the time entry. Required when typeId is time_off.

Response

200

idstring

The unique identifier for the object.

typeId'project_time' | 'time_off'

The type of the time entry.

statusId'not_submitted' | 'pending_approval' | 'approved' | 'rejected'

The approval status of the time entry.

clientStatusId'not_created' | 'pending_approval' | 'approved' | 'rejected' nullable

The client approval status. null when the project does not have client approvals enabled.

datestring date

The date of the time entry. Will be in the form YYYY-MM-DD.

minutesinteger

The number of minutes logged for the time entry.

timerStartedAtstring date-time nullable

The timestamp when the timer was started. null if no timer is active.

notesstring nullable

Notes associated with the time entry.

createdAtstring date-time

The timestamp when the object was created.

modifiedAtstring date-time

The timestamp when the object was last modified.

startTimestring nullable

The local start time of the time entry in HH:mm (24-hour) format.

endTimestring nullable

The local end time of the time entry in HH:mm (24-hour) format.

isBillableboolean

Whether this time entry is billable. This is a calculated value based on the project, role, and other related objects.

invoicedboolean

Whether this time entry has been invoiced. When true, the invoice property will be populated.

rateCurrencystring nullable

The currency code for the billing rate.

ratenumber nullable

The billable rate applicable to this time entry. This is a calculated value based on the project, role, and other related objects.

costCurrencystring nullable

The currency code for the cost rate.

costPerHournumber nullable

The cost per hour for this time entry.

Changes

No recorded changes to this operation across all 1 revision of this API.