---
title: "Create Assessment Task"
method: POST
path: "/api/assessment/v2/assessments/{assessmentId}/tasks"
tags: ["Assessment Actions"]
---

# Create Assessment Task

`POST /api/assessment/v2/assessments/{assessmentId}/tasks`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/assessment/v2/assessments/{assessmentId}/tasks`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `ASSESSMENT`

Use this API to create new tasks on an assessment. Only a single task can be created on an assessment per API call.

 > 🗒 Things to Know  
 > 
 > - Tasks cannot be created for the following assessment types:
 > 
 > - Global Readiness Assessment
 >
 > - Readiness Assessment
 >
 > - Program Benchmarking
 >
 > - Dynamic Incident Notification Assessment

## Path parameters

- `assessmentId` string, uuid, required

## Request body

- PrivacyAutomationAssessmentAutomationTaskCreateRequest
  - `taskName` string, required: Name of the task
  - `description` string: Description of the task
  - `assigneeId` string, uuid: The UUID of the user assigned to the task
  - `deadline` string, date: The date by which the task must be completed
  - `collaborators` PrivacyAutomationAssessmentAutomationTaskCollaboratorDto[]
    - `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)

## Response `201`

Created

- string, uuid

## 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/privacy-automation-assessment-automation.md) - [All operations](https://skmtc.dev/onetrust/apis/privacy-automation-assessment-automation/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/privacy-automation-assessment-automation/revisions/fbdf0c71bfe5?raw)
