--- title: "Get Task" method: GET path: "/v1/tasks/{taskId}" tags: ["Object Task Management"] --- # Get Task `GET /v1/tasks/{taskId}` ## Request - Base URL: `https://hostname/api/custom-entity` - URL: `https://hostname/api/custom-entity/v1/tasks/{taskId}` - Auth: OAuth 2 - Client credentials - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `OBJECT_MANAGER`, `OBJECT_MANAGER_READ`, `OBJECT_MANAGER_WRITE`, `INTEGRATION` Use this API to retrieve a specific task on an object. The response will include details such as the activity history, assignee, and deadline. > 🗒 Things to Know > > - This API only supports objects created via Object Manager, including Projects, Models, and Datasets. ## Path parameters - `taskId` string, uuid, required: Unique identifier of the task to retrieve ## Query parameters - `includePermissionsMetadata` boolean: Whether to include permissions metadata in the response - `excludeInactiveTask` boolean: Whether to exclude inactive tasks from the response ## Response `200` OK - TaskInformation - `id` string, uuid, required: The unique identifier of the task. - `parentEntityId` string, uuid, required: The unique identifier of the parent record where the task was created. - `taskName` string, required: The name of the task. - `taskType` TaskTypeInformation, required - `name` string, required: The name of the task type. - `nameKey` string, required: The name key of the task type used for translation purposes. - `module` string, required: The source product of the task type. - `moduleNameTranslationKey` string, required: The name key of the product used for translation purposes. - `id` string, uuid, required: The unique identifier of the task type. - `label` string, required: The display label of the task type. - `icon` string: The icon of the task type. - `deadline` string, date-time, required: The date and time by which the task should be completed. - `status` 'Open' | 'Closed', required: The status of the task. - `priority` 'LOW' | 'MEDIUM' | 'HIGH', required: The priority level of the task. - `description` string: The description of the task. - `orgGroupId` string, uuid: The unique identifier of the organization responsible for the task. - `orgGroupAttribute` AttributeValue - `valueKey` string, required: The name key of the attribute used for translation purposes. - `value` string, required: The name of the attribute. - `assigneeId` string, uuid: The unique identifier of the user assigned as an assignee on the task. - `isActive` boolean, required: This flag indicates whether the task is active. - `sourceType` string: The type of source that created the task. - `sourceId` string, uuid: The unique identifier of the source that created the task. - `moduleSource` 'assessment' | 'audit-mgmt' | 'cyber-risk' | 'data-mapping' | 'data-governance' | 'esg' | 'erm' | 'incident' | 'issue' | 'itrm' | 'program-benchmarking' | 'maturity-planning' | 'risk' | 'vendor' | 'vendor-portal' | 'compliance-automation' | 'SpeakUp' | 'EntityScoping' | 'ControlObjective' | 'exception': The source product of the task. - `taskAssignmentInformations` TaskAssignmentInformation[]: The details of the task assignment. - `userInfo` UserInfo - `name` string, required: The name of the user or user group. - `nameWithAttributes` string: The name of the user or user group with additional attributes. - `assigneeId` string, uuid, required: The unique identifier of the user or user group assigned to the task. - `type` 'USER' | 'GROUP', required: The type of assignee or collaborator. - `isCollaborator` boolean, required: This flag indicates whether the user or user group was added as a collaborator. - `presentationMode` 'NAVIGATION' | 'DRAWER': The presentation mode of the task. - `isCollaboratorSupported` boolean: This flag indicates whether users can be assigned as collaborators on the task. - `isCollaboratorGroupSupported` boolean: This flag indicates whether user groups can be assigned as collaborators on the task. - `relativeUrl` string: The relative URL associated with the task. - `activity` 'COMPLETE_TASK' | 'REVIEW_DSARSUBTASK' | 'APPROVE_RISK' | 'RESPOND_TO_ASSESSMENT' | 'COMPLETE_AUDIT' | 'REVIEW_REQUEST' | 'COURSE_COMPLETION_PENDING' | 'REVIEW_ASSESSMENT' | 'REVIEW_INCIDENT' | 'IMPLEMENT_CONTROL' | 'RISK_TREATMENT' | 'REVIEW_FINDING' | 'ACKNOWLEDGE_TO_ATTESTATION' | 'REVIEW_INITIATIVE' | 'COMPLETE_DISCLOSURE' | 'COMPLETE_DISCLOSURE_ATTESTATION' | 'EVIDENCE_TASK' | 'COMPLETE_DISC_QUESTIONNAIRE' | 'COMPLIANCE_INITIATIVE' | 'REVIEW_ISSUE' | 'CASE_ASSIGNED' | 'SPEAK_UP_QUESTION_ASSIGNED' | 'CONTROL_OBJECTIVE' | 'REVIEW_EXCEPTION': The type of activity for the task. - `workflowAndStageBasicInformation` object: The details of the workflow and stage. - `workflowId` string, uuid: The unique identifier of the workflow. - `workflowStageId` string, uuid: The unique identifier of the workflow stage. - `stageName` string: The name of the workflow stage. - `stageNameKey` string: The name key of the workflow stage used for translation purposes. - `badgeColor` string: The badge color of the workflow stage. - `dueDateInfo` DueDateInfo - `date` string, date-time, required: The date and time that the task is due. - `color` string, required: The color code for displaying the task due date. - `icon` string, required: The icon of the task due date. - `textKey` string, required: The text key to display with the task due date used for translation purposes. - `numberOfDays` integer, required: The number of days until or past the task due date. - `permissionsMetadata` object: The permissions metadata for the task. - `createdBy` string, uuid: The unique identifier of the user who created the task. - `createdByAttribute` AttributeValue - `valueKey` string, required: The name key of the attribute used for translation purposes. - `value` string, required: The name of the attribute. - `createdDT` string, date-time: The date and time that the task was created. - `modifiedBy` string, uuid: The unique identifier of the user who modified the task. - `modifiedByAttribute` AttributeValue - `valueKey` string, required: The name key of the attribute used for translation purposes. - `value` string, required: The name of the attribute. - `modifiedDT` string, date-time: The date and time that the task was modified. - `completionDate` string, date-time: The date and time that the task was completed. - `isRequired` boolean: This flag indicates whether the task is required. - `canEditRequiredTask` boolean: This flag indicates whether the task can be edited. - `pastDue` boolean: This flag indicates whether the task is past due. - `activityKey` string: The key of the activity type used for translation purposes. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview). - `500`: Internal Server Error --- [API](https://skmtc.dev/onetrust/apis/platform-object-manager.md) - [All operations](https://skmtc.dev/onetrust/apis/platform-object-manager/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/platform-object-manager/revisions/76e5833717c3?raw)