v1

latestOpenAPI 3.1.02026-08-0420819698.7 KB

Routes

Tasks

Labor

Task Labor

This request gets the labor (time spent) on a Task. A single Task can have multiple times logged onto it.

Return data description

meta | This property contains shortcuts to other requests that can be used to get more information regarding the Task the labor was logged on and the user who logged the time. taskID | The Task ID associated with this labor entry. timeSpent | The amount of time measure in seconds. userWage | The wage per hour. description | A description of the labor entry. dateLogged | The date that this time was logged on the Task. billableTime | The amount of time that is billable for this Task. billableRate | The rate at which this labor entry is billed at. categoryID | The labor category this entry is associated with. taskName | The name of the task associated with this labor entry. taskPriorityID | The Priority ID of the task this labor entry is associated with. taskPriorityLevel | The Priority value of the task this labor entry is associated with.

get/v2/tasks/labor

Query parameters

tasksstring

This parameter is used to only get specific Tasks. This parameter accepts a comma delimited list of task IDs.

usersinteger

This parameter is used to only get labor records for a specific user or set of users in a comma delimited list.

startinteger

This parameter is used to only get labor that was logged after the unix timestamp passed into the start parameter. For example, all Assets that were last edited after April 18th, 2018.

endinteger

This parameter is used to only get labor that was logged before the unix timestamp passed into the end parameter.

limitinteger

This parameter is a result limiter. The default is set to return no more than 100 results at one time.

cursorinteger

This parameter is a cursor that selects what taskID you want to start receiving results at. e.g. passing 137 here will only get you tasks with an id greater than 137.

locationsinteger

This parameter is used to retrieve labor entries for particular locations. This parameter accepts a comma delimited list of location IDs.

orderBystring

This parameter is used to order results by their dateLogged property instead of the default ordering. CANNOT be provided alongside the cursor parameter. to paginate in this ordering, use the start or end parameters.

Response

Task Labor

userIDinteger

timeSpentinteger

userWageinteger

taskIDinteger

taskNamestring

tashPriorityIDinteger

{"stackTrail":"paths:/v2/tasks/labor:get:responses:200:content:application/json:schema:items:properties:description","oasType":"schema","type":"unknown"}

dateLoggedinteger

{"stackTrail":"paths:/v2/tasks/labor:get:responses:200:content:application/json:schema:items:properties:billableTime","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/v2/tasks/labor:get:responses:200:content:application/json:schema:items:properties:billableRate","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/v2/tasks/labor:get:responses:200:content:application/json:schema:items:properties:categoryID","oasType":"schema","type":"unknown"}