Skip to content

Get user tasks

Request

Returns tasks assigned to the current user within the account context.

Behavior:

  • Validates account and user context
  • Applies filtering using request parameters
  • Retrieves tasks assigned to the user
  • Returns structured task response data
  • Logs the action as my tasks view
Body
groupBystring or null
assetCategorystring or null
groupItemIdstring or null
groupItemCodestring or null
includeImagesboolean
isClosedOrDiscardTasksboolean or null
projectIdstring or null, (uuid)
projectTaskIdstring or null, (uuid)
taskItemTypestring or null
selectedCalendarDatestring or null
planIdstring or null, (uuid)
isMaintenancePlanboolean
buildingIdstring or null, (uuid)
locationIdstring or null, (uuid)
assetIdstring or null, (uuid)
isCompletedPlannedWorkboolean or null
isCompletedUnPlannedWorkboolean or null
fieldValuesArray of objects or null(zLink.Business.zOne.Base.Common.EntityDataFieldValue)
isAdvancedSearchboolean or null
selectedIdsArray of strings or null, (uuid)
taskIdstring or null, (uuid)
datafieldIdsArray of strings or null
keywordstring or null
sortColumnstring or null
sortColumnIdstring or null, (uuid)
sortOrderstring or null
filterstring or null
curl -i -X POST \
  https://demozone.zlinkfm.com/RND/api/v1/tm/users/me/tasks \
  -H 'Content-Type: application/json-patch+json' \
  -d '{
    "groupBy": "string",
    "assetCategory": "string",
    "groupItemId": "string",
    "groupItemCode": "string",
    "includeImages": true,
    "isClosedOrDiscardTasks": true,
    "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",
    "projectTaskId": "ba4d5958-f73c-44a6-81be-d450913180bb",
    "taskItemType": "string",
    "selectedCalendarDate": "string",
    "planId": "b3f60ba2-c1fd-4b3a-a23d-8e876e0ef75d",
    "isMaintenancePlan": true,
    "buildingId": "fee3295a-6e55-45b0-a091-7b4de7e39de7",
    "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
    "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
    "isCompletedPlannedWork": true,
    "isCompletedUnPlannedWork": true,
    "fieldValues": [
      {
        "dataFieldId": "b6507240-6286-4e43-b3da-bd23ecf1c322",
        "dataFieldValue": "string",
        "dataFieldlabel": "string",
        "dataFieldValueIds": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "fromDate": "string",
        "toDate": "string",
        "dataFieldValueRangeType": "string"
      }
    ],
    "isAdvancedSearch": true,
    "selectedIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "taskId": "e6e9d88a-9b63-468a-aec3-b7a11de27af8",
    "datafieldIds": [
      "string"
    ],
    "keyword": "string",
    "sortColumn": "string",
    "sortColumnId": "0f49f070-9ddb-4e23-bac3-3a9c7797ab4e",
    "sortOrder": "string",
    "filter": "string"
  }'

Responses

OK

Body
dataobject(zLink.Business.zOne.TasksManagement.ResponseModel.TaskResponseModel)
messagestring or null
isErrorboolean
messageCodeinteger, (int32)
statusstring or null
errorTypestring or null
traceidstring or null
responseDescriptionstring or null
Response
{
  "data": {
    "data": [
      {
        "groupName": "string",
        "tasks": [
          {
            "uniqueId": "a1e12d74-d756-40d1-9bb3-519def353f44",
            "taskNumber": "string",
            "taskDescription": "string",
            "expectedDateOfCompletion": "string",
            "status": {
              "statusId": "e900225c-0629-4e96-be6e-86a17a309645",
              "statusCode": "string",
              "statusName": "string",
              "statusColor": "string"
            },
            "taskItemType": "string",
            "taskItemTypeName": "string",
            "priority": {
              "priorityName": "string",
              "priorityRank": 0,
              "description": "string",
              "priorityColorCode": "string",
              "priorityId": "a57eab25-838b-40cc-a576-57e4056f1d6c"
            },
            "locationInfo": {
              "type": "string",
              "features": [
                null
              ]
            },
            "locationDetail": {
              "location": "string",
              "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
              "building": "string",
              "buildingId": "fee3295a-6e55-45b0-a091-7b4de7e39de7",
              "level": "string",
              "levelId": "a70368c7-b12e-43a9-9830-ab2485710b95",
              "room": "string",
              "roomId": "c3631f02-ff67-42b8-8775-18c47f52a678",
              "workspace": "string",
              "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c",
              "spaceKey": "string",
              "spaceAssignedOn": "string",
              "spaceCategory": {},
              "roomFunction": {},
              "spaceArea": 0.1,
              "levelPlanHandle": "string",
              "employeeLocationId": "2e9ca96c-a4c6-4bdb-b2bb-33d9e60c3f1c",
              "rollBackInfo": {},
              "levelPlanId": "0f5a21ff-233b-4dbc-8296-4521bcd60dc1",
              "planFile": {},
              "cadPlanCoordinates": [
                null
              ],
              "spaceAssignedOnDateTimeFormat": "string",
              "svgPlanAdded": true
            },
            "lastAction": "string",
            "workType": {
              "workFlow": {},
              "worktypeCategories": [
                null
              ],
              "worktypeId": "28eb7caa-2c70-4ac0-adbe-25b091f7c6ba",
              "worktypeName": "string",
              "worktypeCode": "string",
              "worktypeDescription": "string",
              "autoApproveNewRequest": true,
              "canUpdateRequestDescription": true
            },
            "additionalInfo": [
              {
                "dataIds": []
              }
            ],
            "workTypeCategory": {
              "worktypeCategoryId": "5c846d9d-ca66-4d9c-a44e-ce03518d28af",
              "worktypeCategoryName": "string",
              "worktypeCategoryCode": "string",
              "worktypeCategoryDescription": "string",
              "autoApproveNewRequest": true,
              "parentWorkTypeCategory": {},
              "levelOrdinal": 0,
              "workType": {},
              "workFlow": {},
              "worktypeCategories": [
                null
              ],
              "canUpdateRequestDescription": true
            },
            "title": "string",
            "files": [
              {
                "customProperties": {}
              }
            ],
            "hasAnyOnGoingLabours": true,
            "currentActionPoint": "string",
            "actionBy": "string",
            "lastActionBy": "string",
            "locationName": "string",
            "buildingName": "string",
            "requestedBy": "string",
            "requestedOn": "string",
            "planProcedure": "string",
            "planName": "string",
            "dueDate": "string",
            "actionById": [
              null
            ],
            "totalLabourHours": "string",
            "totalCost": "string",
            "labourHours": 0.1,
            "cost": 0.1,
            "loggedInUserExistInForActionby": true,
            "serviceRequestInitialInfo": [
              {
                "dataIds": []
              }
            ],
            "taskId": 0,
            "buildingInfo": {
              "type": "string",
              "features": [
                null
              ]
            },
            "expectedCompletionDate": "2019-08-24T14:15:22Z",
            "workOrderDate": "2019-08-24T14:15:22Z",
            "estimatedHours": 0.1,
            "linearAssetIds": [
              0
            ],
            "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
            "buildingId": "fee3295a-6e55-45b0-a091-7b4de7e39de7",
            "levelId": "a70368c7-b12e-43a9-9830-ab2485710b95",
            "projectId": 0,
            "projectTaskId": 0,
            "taskWorkType": "string",
            "currentActionPointId": 0,
            "actionPointPermissionData": [
              {}
            ],
            "taskDueDate": "2019-08-24T14:15:22Z"
          }
        ],
        "groupType": "string",
        "groupObject": null,
        "groupCode": "string",
        "taskCount": 0
      }
    ],
    "tasksCount": 0,
    "recentTasks": [
      {
        "uniqueId": "a1e12d74-d756-40d1-9bb3-519def353f44",
        "taskNumber": "string",
        "taskDescription": "string",
        "expectedDateOfCompletion": "string",
        "status": {
          "statusId": "e900225c-0629-4e96-be6e-86a17a309645",
          "statusCode": "string",
          "statusName": "string",
          "statusColor": "string"
        },
        "taskItemType": "string",
        "taskItemTypeName": "string",
        "priority": {
          "priorityName": "string",
          "priorityRank": 0,
          "description": "string",
          "priorityColorCode": "string",
          "priorityId": "a57eab25-838b-40cc-a576-57e4056f1d6c"
        },
        "locationInfo": {
          "type": "string",
          "features": [
            {
              "type": "string",
              "id": 0,
              "properties": {},
              "geometry": {}
            }
          ]
        },
        "locationDetail": {
          "location": "string",
          "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
          "building": "string",
          "buildingId": "fee3295a-6e55-45b0-a091-7b4de7e39de7",
          "level": "string",
          "levelId": "a70368c7-b12e-43a9-9830-ab2485710b95",
          "room": "string",
          "roomId": "c3631f02-ff67-42b8-8775-18c47f52a678",
          "workspace": "string",
          "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c",
          "spaceKey": "string",
          "spaceAssignedOn": "string",
          "spaceCategory": {
            "spaceCategoryId": "809d6029-69b4-43c2-a738-11abe5eaf804",
            "spaceCategoryName": "string",
            "spaceCategoryCode": "string"
          },
          "roomFunction": {
            "roomFunctionId": "21215e30-d522-4a6e-b350-1cf0e9b3df3c",
            "roomFunctionName": "string"
          },
          "spaceArea": 0.1,
          "levelPlanHandle": "string",
          "employeeLocationId": "2e9ca96c-a4c6-4bdb-b2bb-33d9e60c3f1c",
          "rollBackInfo": {
            "isRollBack": true,
            "rollBackType": "string",
            "employeeLocationId": "2e9ca96c-a4c6-4bdb-b2bb-33d9e60c3f1c",
            "comments": "string"
          },
          "levelPlanId": "0f5a21ff-233b-4dbc-8296-4521bcd60dc1",
          "planFile": {
            "fileId": "a1c6a2ab-4b01-4253-b4c9-70e04b3b48fc",
            "fileName": "string",
            "fileSize": "string",
            "currentRevisionNumber": 0,
            "createdOn": "string",
            "fileSizeInBytes": 0,
            "createdDate": "2019-08-24T14:15:22Z",
            "createdBy": "string",
            "isLatest": true
          },
          "cadPlanCoordinates": [
            0.1
          ],
          "spaceAssignedOnDateTimeFormat": "string",
          "svgPlanAdded": true
        },
        "lastAction": "string",
        "workType": {
          "workFlow": {
            "workflowId": "43c4fa9b-0cbc-4b57-a121-9d7d46a3eaa4",
            "workflowName": "string",
            "workflowCode": "string",
            "workflowRevisions": 0,
            "responseDescription": "string"
          },
          "worktypeCategories": [
            {
              "worktypeCategoryId": "5c846d9d-ca66-4d9c-a44e-ce03518d28af",
              "worktypeCategoryName": "string",
              "worktypeCategoryCode": "string",
              "worktypeCategoryDescription": "string",
              "autoApproveNewRequest": true,
              "parentWorkTypeCategory": {},
              "levelOrdinal": 0,
              "workType": {},
              "workFlow": {},
              "worktypeCategories": [
                null
              ],
              "canUpdateRequestDescription": true
            }
          ],
          "worktypeId": "28eb7caa-2c70-4ac0-adbe-25b091f7c6ba",
          "worktypeName": "string",
          "worktypeCode": "string",
          "worktypeDescription": "string",
          "autoApproveNewRequest": true,
          "canUpdateRequestDescription": true
        },
        "additionalInfo": [
          {
            "dataField": "string",
            "dataFieldId": "b6507240-6286-4e43-b3da-bd23ecf1c322",
            "dataIds": [
              "497f6eca-6276-4993-bfeb-53cbbbba6f08"
            ],
            "dataFieldValue": null,
            "dataFieldName": "string",
            "dataValueFormated": "string"
          }
        ],
        "workTypeCategory": {
          "worktypeCategoryId": "5c846d9d-ca66-4d9c-a44e-ce03518d28af",
          "worktypeCategoryName": "string",
          "worktypeCategoryCode": "string",
          "worktypeCategoryDescription": "string",
          "autoApproveNewRequest": true,
          "parentWorkTypeCategory": {},
          "levelOrdinal": 0,
          "workType": {
            "worktypeId": "28eb7caa-2c70-4ac0-adbe-25b091f7c6ba",
            "worktypeName": "string",
            "worktypeCode": "string",
            "worktypeDescription": "string",
            "autoApproveNewRequest": true,
            "canUpdateRequestDescription": true
          },
          "workFlow": {
            "workType": {
              "worktypeId": "28eb7caa-2c70-4ac0-adbe-25b091f7c6ba",
              "worktypeName": "string",
              "worktypeCode": "string",
              "worktypeDescription": "string",
              "autoApproveNewRequest": true,
              "canUpdateRequestDescription": true
            },
            "workflowId": "43c4fa9b-0cbc-4b57-a121-9d7d46a3eaa4",
            "workflowName": "string",
            "workflowCode": "string",
            "workflowRevisions": 0,
            "responseDescription": "string"
          },
          "worktypeCategories": [
            {}
          ],
          "canUpdateRequestDescription": true
        },
        "title": "string",
        "files": [
          {
            "fileName": "string",
            "fileId": "a1c6a2ab-4b01-4253-b4c9-70e04b3b48fc",
            "fileSize": "string",
            "dateAddedOn": "string",
            "isLinkedDocument": true,
            "preview": {
              "hasFilePreview": true,
              "hasFileThumbnail": true,
              "previewURL": "string",
              "thumbnailUrl": "string"
            },
            "fileType": {
              "fileTypeId": "4e54faea-5a86-4e82-9bdd-545d4e485d6f",
              "fileTypeName": "string",
              "fileTypeIconURL": "string",
              "fileExtentions": [
                null
              ]
            },
            "isImage": true,
            "isCadFile": true,
            "customProperties": {
              "property1": null,
              "property2": null
            },
            "isEditable": true,
            "addedBy": "string",
            "fileSizeInBytes": 0,
            "fileStatus": {
              "statusId": "e900225c-0629-4e96-be6e-86a17a309645",
              "statusCode": "string",
              "statusName": "string",
              "statusColor": "string"
            },
            "revisionNumber": 0,
            "addedOn": "2019-08-24T14:15:22Z",
            "isFavorite": true,
            "folderPath": "string",
            "categoryUniqueId": "57929879-040e-4360-a67f-564710268d7d",
            "categoryLevelOrdinal": 0,
            "documentNumber": "string",
            "fileGroupId": "4aa913cb-e81a-45b1-a40b-6c8de6d85028",
            "hasPermissionToUpdate": true,
            "responseDescription": "string"
          }
        ],
        "hasAnyOnGoingLabours": true,
        "currentActionPoint": "string",
        "actionBy": "string",
        "lastActionBy": "string",
        "locationName": "string",
        "buildingName": "string",
        "requestedBy": "string",
        "requestedOn": "string",
        "planProcedure": "string",
        "planName": "string",
        "dueDate": "string",
        "actionById": [
          null
        ],
        "totalLabourHours": "string",
        "totalCost": "string",
        "labourHours": 0.1,
        "cost": 0.1,
        "loggedInUserExistInForActionby": true,
        "serviceRequestInitialInfo": [
          {
            "dataField": "string",
            "dataFieldId": "b6507240-6286-4e43-b3da-bd23ecf1c322",
            "dataIds": [
              "497f6eca-6276-4993-bfeb-53cbbbba6f08"
            ],
            "dataFieldValue": null,
            "dataFieldName": "string",
            "dataValueFormated": "string"
          }
        ],
        "taskId": 0,
        "buildingInfo": {
          "type": "string",
          "features": [
            {
              "type": "string",
              "id": 0,
              "properties": {},
              "geometry": {}
            }
          ]
        },
        "expectedCompletionDate": "2019-08-24T14:15:22Z",
        "workOrderDate": "2019-08-24T14:15:22Z",
        "estimatedHours": 0.1,
        "linearAssetIds": [
          0
        ],
        "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
        "buildingId": "fee3295a-6e55-45b0-a091-7b4de7e39de7",
        "levelId": "a70368c7-b12e-43a9-9830-ab2485710b95",
        "projectId": 0,
        "projectTaskId": 0,
        "taskWorkType": "string",
        "currentActionPointId": 0,
        "actionPointPermissionData": [
          {
            "permissionId": "d5850203-7a23-4b4d-8f1b-99d510b781d3",
            "permissionName": "string",
            "permissionCode": "string",
            "accessControl": "string"
          }
        ],
        "taskDueDate": "2019-08-24T14:15:22Z"
      }
    ]
  },
  "message": "string",
  "isError": true,
  "messageCode": 0,
  "status": "string",
  "errorType": "string",
  "traceid": "string",
  "responseDescription": "string"
}