Edits multiple time entries using the specified operation. | awork API

Supported Operations: delete: Deletes all time entries. Only admins can delete already billed time entries. setTypeOfWork: Changes the type of work for a list of time entries. TODO: check if only admins should be able to change for billed. setIsBillable: 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. setIsBilled: 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. setProject: 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. setTask: 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. setUser: Changes the user for a list of time entries. Only admins can change the user for already billed time entries.

Required Permissions

Any authenticated user.

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. Supported Operations: delete: Deletes all time entries. Only admins can delete already billed time entries. setTypeOfWork: Changes the type of work for a list of time entries. TODO: check if only admins should be able to change for billed. setIsBillable: 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. setIsBilled: 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. setProject: 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. setTask: 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. setUser: Changes the user for a list of time entries. Only admins can change the user for already billed time entries. <Check title="Required Permissions">Any authenticated user.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

operationstringRequired

The name of the operation to execute on the given time entries. Valid values are: delete, setTypeOfWork, setIsBillable, setIsBilled, setProject, setTask, setUser.

Request

The form with additional info for the batch operation.

timeEntryIdslist of stringsRequired

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

newTypeOfWorkIdstring or nullOptionalformat: "uuid"

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

isBillableboolean or nullOptional

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

isBilledboolean or nullOptional

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

newUserIdstring or nullOptionalformat: "uuid"

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

newProjectIdstring or nullOptionalformat: "uuid"

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

newTaskIdstring or nullOptionalformat: "uuid"

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

Response

okobject or null

notFoundobject or null

unauthorizedobject or null

badRequestobject or null

Required Permissions

Any authenticated user.

1	curl -X POST https://api.awork.com/api/v1/timeentries/batch/operation \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"timeEntryIds": [
6	"string"
7	]
8	}'

1	{
2	"ok": {
3	"ids": [
4	"string"
5	]
6	},
7	"notFound": {
8	"ids": [
9	"string"
10	]
11	},
12	"unauthorized": {
13	"ids": [
14	"string"
15	]
16	},
17	"badRequest": {
18	"ids": [
19	"string"
20	]
21	}
22	}