v2

latestSwagger 2.02026-08-04108164321.0 KB
Timesheet

Updates an existing timesheet entry. Only fields listed in FieldsToUpdate will be modified. ProjectIDFK is always required.

put/api/Timesheet

Request body

TimeSheetEntryIDinteger required

The ID of the timesheet entry to update.

FieldsToUpdatestring[] required

Array of field names to update. Only listed fields will be modified.

ProjectIDFKinteger required

The project ID for the timesheet entry. Always required.

TimesheetCategoryIDFKinteger

The timesheet category ID to apply to this entry.

TaskIDFKinteger

The task ID to link this entry to, if any.

Durationnumber double

Duration of the timesheet entry in decimal hours.

EntryDatestring date-time

The date of the timesheet entry.

hasStartEndTimeboolean

If true, the start time is taken from the time component of EntryDate and the end time is calculated by adding Duration.

Notesstring

Free-text notes for the timesheet entry.

CustomMetadatastring

Optional. free nvarchar field available via Api to store any additional metadata against a timesheet. We suggest you use Json or your preferred serialisation format. 1000 characters max.

SendWebhooksboolean

If true, fires the timesheet_updated webhook event to any subscribed endpoints. Defaults to false to preserve existing integration behaviour.

Response

Returns the updated timesheet entry details.

TimesheetEntryIDinteger

Unique identifier for the timesheet entry.

UserIDFKinteger

The ID of the user who owns this timesheet entry.

Firstnamestring

First name of the timesheet user.

Lastnamestring

Last name of the timesheet user.

Emailstring

Email address of the timesheet user.

ProjectIDFKinteger

The project ID this timesheet entry is associated with.

ProjectTitlestring

Title of the associated project.

ProjectCodestring

Project code of the associated project, if project codes are enabled.

CustomerIDFKinteger

The customer/company ID associated with the project.

CustomerNamestring

Name of the customer/company associated with the project.

TimesheetCategoryIDFKinteger

The timesheet category ID applied to this entry.

CategoryNamestring

Name of the timesheet category applied to this entry.

Durationnumber double

Duration of the timesheet entry in decimal hours.

TimesheetEntryApprovalStatusCodestring

Approval status of the entry. Values: Draft, Pending, Approved, Rejected, AutoApproved.

HasTimerboolean

Whether a timer is currently running on this entry.

TimerStartedAtUTCstring date-time

The UTC date and time at which the timer was started, if a timer is running.

isBillableboolean

Whether this timesheet entry is billable to the client.

isInvoicedboolean

Whether this timesheet entry has been included on an invoice.

EntryDatestring date-time

The date of the timesheet entry.

StartTimeLocalstring date-time

The local start time of the entry, if start/end time tracking is enabled.

StartTimeUTCstring date-time

The UTC start time of the entry, if start/end time tracking is enabled.

EndTimeLocalstring date-time

The local end time of the entry, if start/end time tracking is enabled.

EndTimeUTCstring date-time

The UTC end time of the entry, if start/end time tracking is enabled.

TimesheetUserTimeZonestring

The IANA time zone ID of the user who owns the timesheet.

Notesstring

Free-text notes attached to this timesheet entry.

TaskIDFKinteger

The task ID this timesheet entry is linked to, if any.

TaskTitlestring

Title of the task this entry is linked to.

InvoiceIDFKinteger

The invoice Transaction ID this entry was billed on, if invoiced.

InvoiceLineItemIDFKinteger

The invoice line item ID this entry was billed on, if invoiced.

DateCreatedstring date-time

Date and time the record was created (UTC).

DateUpdatedstring date-time

Date and time the record was last updated (UTC).

DateApprovedstring date-time

Date and time the entry was approved, if applicable.

ApprovedBystring

Name or email of the user who approved this entry.

CustomMetadatastring

Optional free-form metadata field for storing additional information. Maximum 1000 characters.

RateAmountnumber double

Only visible to Admin role users

CostAmountnumber double

Only visible to Admin role users

ViewTimesheetURLstring

URL to view this timesheet entry's day in the Avaza web application.