---
title: "Create Task"
method: POST
path: "/api/task-management/v1/tasks"
tags: ["Tasks"]
---

# Create Task

`POST /api/task-management/v1/tasks`

Use this API to create a new task for an object.

> 🗒 Things to Know
> 
> - This API currently supports issue tasks. Support for tasks on additional objects may be made available in the future.

## Request body

- TaskCreateRequest
  - `parentEntityId` string, uuid, required — ID of the parent entity
  - `taskName` string, required — Name of the task
  - `description` string — Description of the task
  - `orgGroupId` string, uuid, required — Organization group ID
  - `taskTypeNameKey` string, required — Key identifying the task type
  - `assigneeId` string, uuid — ID of the assignee
  - `assigneeEmail` string — Email of the assignee
  - `collaborators` TaskCollaboratorDto[] — List of task collaborators
    - `collaboratorId` string, uuid — Unique identifier of the collaborator
    - `collaboratorEmail` string — Email address of the collaborator
    - `type` 'USER' | 'GROUP', required — Type of assignee (User or Group)
  - `deadline` string, date-time — Deadline for the task
  - `context` TaskContextInformation
    - `parameters` object — Dynamic key-value parameters for task context
  - `isActive` boolean — Flag indicating if the task is active
  - `sourceType` string — Type of source that created the task
  - `sourceId` string, uuid — ID of the source that created the task
  - `resourceId` string, uuid — ID of the resource
  - `resourceTypeNameKey` string — Key identifying the resource type
  - `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' — Source module
  - `priority` 'LOW' | 'MEDIUM' | 'HIGH' — Priority level of the task
  - `isRequired` boolean — Flag indicating if the task is required

## Response `201`

Task created successfully

- TaskInformation
  - `id` string, uuid, required — Unique identifier for the task
  - `parentEntityId` string, uuid, required — Identifier of the parent entity
  - `taskName` string, required — Name of the task
  - `taskType` TaskTypeInformation, required
    - `name` string, required — Name of the task type
    - `nameKey` string, required — Translation key for the task type name
    - `module` string, required — Module that this task type belongs to
    - `moduleNameTranslationKey` string, required — Translation key for the module name
    - `id` string, uuid, required — Unique identifier for the task type
    - `label` string, required — Display label for the task type
    - `icon` string — Icon identifier for the task type
  - `deadline` string, date-time, required — Deadline for completing the task
  - `status` 'Open' | 'Closed', required — Current status of the task
  - `priority` 'LOW' | 'MEDIUM' | 'HIGH', required — Priority level of the task
  - `description` string — Detailed description of the task
  - `orgGroupId` string, uuid — Organization group identifier associated with the task (deprecated)
  - `orgGroupAttribute` AttributeValue
    - `valueKey` string, required — Key or identifier for the attribute value
    - `value` string, required — The display value of the attribute
  - `assigneeId` string, uuid — ID of the task assignee
  - `isActive` boolean, required — Indicates if the task is active
  - `sourceType` string — The source type that created the task
  - `sourceId` string, uuid — ID 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' — Source module for the task
  - `taskAssignmentInformations` TaskAssignmentInformation[] — List of assignment information for the task
    - `userInfo` UserInfo
      - `id` string, uuid — The unique identifier of the user responsible for the initiative.
      - `active` boolean — This flag indicates whether the user responsible for the initiative is active.
      - `name` string — The name of the user responsible for the initiative.
    - `assigneeId` string, uuid, required — Unique identifier of the assignee (user or group)
    - `type` 'USER' | 'GROUP', required — Type of the assignee (user or group)
    - `isCollaborator` boolean, required — Indicates if this assignment is as a collaborator or primary assignee
  - `presentationMode` 'NAVIGATION' | 'DRAWER' — The presentation mode for the task
  - `isCollaboratorSupported` boolean — Indicates if collaborators are supported for this task
  - `isCollaboratorGroupSupported` boolean — Indicates if collaborator groups are supported for this task
  - `relativeUrl` string — 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' — Activity type for the task
  - `workflowAndStageBasicInformation` object — Basic information about workflow and current stage
  - `workflowId` string, uuid — ID of the workflow associated with the task
  - `workflowStageId` string, uuid — ID of the workflow stage associated with the task
  - `stageName` string — Name of the current workflow stage
  - `stageNameKey` string — Translation key for the stage name
  - `badgeColor` string — Color of the badge for the current stage
  - `dueDateInfo` DueDateInfo
    - `date` string, date-time, required — The due date timestamp
    - `color` string, required — Color code for displaying the due date
    - `icon` string, required — Icon identifier for the due date status
    - `textKey` string, required — Translation key for text to display with the due date
    - `numberOfDays` integer, required — Number of days until or past the due date
  - `permissionsMetadata` object — Metadata about permissions for this task
  - `createdBy` string, uuid — ID of the user who created the task (deprecated)
  - `createdByAttribute` AttributeValue
    - `valueKey` string, required — Key or identifier for the attribute value
    - `value` string, required — The display value of the attribute
  - `createdDT` string, date-time — Date and time when the task was created
  - `modifiedBy` string, uuid — ID of the user who last modified the task (deprecated)
  - `modifiedByAttribute` AttributeValue
    - `valueKey` string, required — Key or identifier for the attribute value
    - `value` string, required — The display value of the attribute
  - `modifiedDT` string, date-time — Date and time when the task was last modified
  - `completionDate` string, date-time — Date and time when the task was completed
  - `isRequired` boolean — Indicates if the task is required
  - `canEditRequiredTask` boolean — Indicates if a required task can be edited
  - `pastDue` boolean
  - `activityKey` string

## 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.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)