---
title: "Update Task"
method: PUT
path: "/api/ai-governance/v1/tasks/{taskId}"
tags: ["Task Management"]
---

# Update Task

`PUT /api/ai-governance/v1/tasks/{taskId}`

Use this API to update an existing task for an entity.

> 🗒 Things to Know
> 
> - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents).
> - AI Governance APIs will become available over the course of the Spring as customer tenants are upgraded to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation.

## Path parameters

- `taskId` string, uuid, required — Task identifier

## Request body

- TaskUpdateRequest
  - `taskName` string, required — Name of the task
  - `description` string — Description of the task
  - `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
  - `status` 'Open' | 'Closed' — Status of the task
  - `context` TaskContextInformation
    - `parameters` object — Dynamic key-value parameters for task context
  - `priority` 'LOW' | 'MEDIUM' | 'HIGH' — Priority level of the task
  - `isRequired` boolean — Flag indicating if the task is required
  - `sourceType` string — Type of source that created the task
  - `sourceId` string, uuid — ID of the source that created the task

## Response `200`

OK

- 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/revisions/21de3aa0b170/schema)