For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportContact salesStart free trial
  • Getting started
    • Overview
    • Authentication
    • Querying tutorial
    • OData Integrations
    • Work Breakdown Structure
    • Software Development Kits
    • API Patch Notes
    • FAQ
    • Terms of use
  • API Reference
      • GETQuery Tasks
      • GETRetrieve Task
      • PUTUpdate Task
      • DELDelete Task
      • GETFetch the first level child tasks from the task
      • POSTCreate Task
      • GETRetrieve Task Priorities
      • POSTCreate Many Tasks
      • POSTAdd Parent Task
      • PUTUpdate Parent Task
      • DELRemove Parent Task
      • PUTUpdate the approval status of a Task.
      • POSTMark task as read for the current user
      • GETPlanned allocations and actual timesheet minutes for a task, grouped by resource.
LogoLogo
SupportContact salesStart free trial
API ReferenceTask

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.
Was this page helpful?
Previous

Returns task assignees

Next
Built with

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

Headers

x-integration-namestringOptional
The name of the calling system passed along as a header parameter

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).