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
      • GETGet Npts
      • POSTCreate Npt
      • GETGet Npt
      • PUTUpdate Npt
      • DELRemove Npt
      • GETPlanned allocations and actual timesheet minutes for a non-project task, grouped by resource.
LogoLogo
SupportContact salesStart free trial
API ReferenceNpt

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

GET
https://api.projectmanager.com/api/data/non-project-tasks/:nptId/time
GET
/api/data/non-project-tasks/:nptId/time
$curl https://api.projectmanager.com/api/data/non-project-tasks/nptId/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 NPT, grouped by resource. Use this when the client needs time rollups without loading individual timesheet entries. The root `totalActualMinutes` is at least the task's stored actual work (minutes) and the merged timesheet total. `hasTimeEntries` is true only when merged timesheet rows exist, not when actual work was set without timesheets (e.g. import).
Was this page helpful?
Previous

Retrieve Npt Comments

Next
Built with

Returns a summary of planned allocations and logged timesheet minutes for the specified NPT, grouped by resource. Use this when the client needs time rollups without loading individual timesheet entries. The root totalActualMinutes is at least the task’s stored actual work (minutes) and the merged timesheet total. hasTimeEntries is true only when merged timesheet rows exist, not when actual work was set without timesheets (e.g. import).

Authentication

AuthorizationBearer

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

Path parameters

nptIdstringRequiredformat: "uuid"

The unique identifier of the non-project 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).