Planned allocations and actual timesheet minutes for a task, grouped by resource.

GET

https://api.projectmanager.com/api/data/task/:taskId/time

GET

/api/data/task/:taskId/time

$ curl https://api.projectmanager.com/api/data/task/taskId/time \
>      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "error": {
3     "technicalError": "string",
4     "additionalErrors": [
5       "string"
6     ],
7     "validationErrors": {},
8     "message": "string"
9   },
10   "success": true,
11   "hasError": true,
12   "statusCode": "Continue",
13   "data": {
14     "totalPlannedMinutes": 1,
15     "totalAssignedMinutes": 1,
16     "totalActualMinutes": 1,
17     "hasTimeEntries": true,
18     "assigned": [
19       {
20         "id": "string",
21         "totalMinutes": 1,
22         "allocations": [
23           {
24             "date": "2023-01-15",
25             "minutes": 1
26           }
27         ]
28       }
29     ],
30     "actual": [
31       {
32         "id": "string",
33         "totalMinutes": 1,
34         "timeEntries": [
35           {
36             "id": "string",
37             "date": "2023-01-15",
38             "minutes": 1,
39             "approved": true,
40             "approvalStatusId": 1
41           }
42         ]
43       }
44     ]
45   }
46 }

Returns a summary of planned allocations and logged timesheet minutes for the specified task, grouped by resource. Use this when the client needs time rollups without loading individual timesheet entries.

Authentication

AuthorizationBearer

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

Path parameters

taskIdstringRequiredformat: "uuid"

The unique identifier of the task

Response

Success

errorobject or null

If the API call failed, this will contain information about the error that occurred.

successbooleanRead-only

True if the API call succeeded; false otherwise.

hasErrorbooleanRead-only

True if the API call failed.

statusCodeenum

The HTTP code of the response.

dataobject

Task-level planned work (TotalPlannedMinutes from task Work), per-resource assigned breakdown (Assigned / TotalAssignedMinutes), workspace-wide reported actual total (TotalActualMinutes), per-resource reported timesheet rows (Actual), scoped by permission, and HasTimeEntries (whether any logged minutes exist for the task in the workspace, regardless of Actual visibility).

Authentication

Path parameters

Headers

Response