v1

latestOpenAPI 3.1.02026-08-066984441.1 MB
timeEntries

Edits multiple time entries using the specified operation.

The user is only allowed to edit time entries they have permissions for. Returns MultiStatus. Includes the list of successfully changed, not found, unauthorized, and invalid time entry ids. Returns BadRequest if the validation of the form fails, f.e. the new type of work cannot be found. Returns NotFound if the operation route value is not supported.

         Supported Operations:
         <ul>
<li> <i>delete</i>: Deletes all time entries. Only admins can delete already billed time entries.</li> <li> <i>setTypeOfWork</i>: Changes the type of work for a list of time entries.</li> <li> <i>setIsBillable</i>: Changes the billability for a list of time entries. Already billed time entries can only be changed to being unbillable by admins. In this case, the IsBilled flag is also set to false.</li> <li> <i>setIsBilled</i>: Changes the billing status for a list of time entries. Only admins can change the billing status back to unbilled for already billed time entries.</li> <li> <i>setProject</i>: Changes the project for a list of time entries. Only admins can change the project for already billed time entries. Setting the project unsets the previous project and task.</li> <li> <i>setTask</i>: Changes the task for a list of time entries. Only admins can change the task for already billed time entries. Setting the task automatically sets the project if that task is a project task.</li> <li> <i>setUser</i>: Changes the user for a list of time entries. Only admins can change the user for already billed time entries.</li> </ul>

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

post/timeentries/batch/{operation}

Path parameters

operationstring required

The batch operation type.

Headers

Authorizationstring required

Bearer authentication

Request body

timeEntryIdsstring[] required

The list of time entry ids to perform the batch operation on.

newTypeOfWorkIdstring uuid nullable

The id of the new type of work. Required for operation 'setTypeOfWork'.

isBillableboolean nullable

Set the billable flag for time entries. Required for operation 'setIsBillable'.

isBilledboolean nullable

Set the billed flag for time entries. Required for operation 'setIsBilled'.

newUserIdstring uuid nullable

The id of the new user to assign the time entries to. Required for operation 'setUser'.

newProjectIdstring uuid nullable

The id of the new project to assign the time entries to. Required for operation 'setProject'.

newTaskIdstring uuid nullable

The id of the new task to assign the time entries to. Required for operation 'setTask'.

Response

Multi-Status