timeEntries

Updates the time entry.

Changed on

Updates the time entry. The break duration of the time entry is kept the same. The break duration cannot be smaller than the duration of the time entry. To remove the breaks, use the endpoint POST /timeentries/{id}/removeBreaks. Following combination of times and duration are allowed for already completed time entries: - start time (local or utc) and end time (local or utc) (this option always takes precedence) - start time (local or utc) and duration - end time (local or utc) and duration For running time entries, you can only update the start time (local or utc) while the duration stays 0. <Check title="Required Permissions" icon="key">The user must have permission to access the requested resource.</Check>

put/timeentries/{timeEntryId}

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/timeentries/{timeEntryId}
  • Auth: HTTP bearer

Path parameters

timeEntryIdstring uuid required

The id of the time entry.

Request body

isBillableboolean

Whether the time tracking is billable or not.

isBilledboolean

Whether the time tracking is billed or not.

taskIdstring uuid nullable

The id of the task.

projectIdstring uuid nullable

The id of the project.

notestring nullable

The note of the time tracking.

startDateUtcstring date-time nullable

The date (in UTC) when the time tracking was started.

startTimeUtcstring nullable

The time (in UTC) when the time tracking was started.

endDateUtcstring date-time nullable

The date (in UTC) when the time tracking was stopped.

endTimeUtcstring nullable

The time (in UTC) when the time tracking was stopped. Required when the time tracking has already been completed and Duration has not been set.

startDateLocalstring date-time nullable

The date (in Local) when the time tracking was started.

startTimeLocalstring nullable

The time (in Local) when the time tracking was started.

endDateLocalstring date-time nullable

The date (in Local) when the time tracking was stopped.

endTimeLocalstring nullable

The time (in Local) when the time tracking was stopped. Required when the time tracking has already been completed and Duration has not been set.

timezonestring required

The original timezone of the time tracking. The format of the timezone is the IANA standard.

durationinteger nullable

The duration of the time tracking in seconds. Required when the time tracking has already been completed and EndTime has not been set.

breakDurationinteger nullable

The duration of the break in seconds. Cannot be set via API.

typeOfWorkIdstring uuid required

The id of the type of work.

userIdstring uuid nullable

The id of the user. Can be null if the user was deleted.

Response

OK

isBillableboolean

Whether the time tracking is billable or not.

isBilledboolean

Whether the time tracking is billed or not.

taskIdstring uuid nullable

The id of the task.

projectIdstring uuid nullable

The id of the project.

notestring nullable

The note of the time tracking.

startDateUtcstring date-time nullable

The date (in UTC) when the time tracking was started.

startTimeUtcstring nullable

The time (in UTC) when the time tracking was started.

endDateUtcstring date-time nullable

The date (in UTC) when the time tracking was stopped.

endTimeUtcstring nullable

The time (in UTC) when the time tracking was stopped. Required when the time tracking has already been completed and Duration has not been set.

startDateLocalstring date-time nullable

The date (in Local) when the time tracking was started.

startTimeLocalstring nullable

The time (in Local) when the time tracking was started.

endDateLocalstring date-time nullable

The date (in Local) when the time tracking was stopped.

endTimeLocalstring nullable

The time (in Local) when the time tracking was stopped. Required when the time tracking has already been completed and Duration has not been set.

timezonestring required

The original timezone of the time tracking. The format of the timezone is the IANA standard.

durationinteger nullable

The duration of the time tracking in seconds. Required when the time tracking has already been completed and EndTime has not been set.

breakDurationinteger nullable

The duration of the break in seconds. Cannot be set via API.

typeOfWorkIdstring uuid required

The id of the type of work.

userIdstring uuid nullable

The id of the user. Can be null if the user was deleted.

idstring uuid

The id of the time tracking.

createdBystring uuid

The id of the user who created this time tracking.

createdOnstring date-time

The date this time tracking was created.

updatedBystring uuid

The id of the user who last updated this time tracking.

updatedOnstring date-time

The date this time tracking was last modified.

resourceVersioninteger

The version of the entity, updated on every modification, to the ticks in UTC. Not identical to UpdatedOn.

isExternalboolean

True if this entity is coming from an external workspace (awork Connect).

Changes

  • 1556e0487867Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e46cf415581Revision changes
    • info

      api operation id PutTimeEntryById removed and replaced with timeEntries_PutTimeEntryById