v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB
Assessment Actions

Create Assessment Task

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

post/api/assessment/v2/assessments/{assessmentId}/tasks

Path parameters

assessmentIdstring uuid required

The unique ID of the assessment in which to create the task.

Request body

taskNamestring required

Name of the task

descriptionstring

Description of the task

assigneeIdstring uuid

The UUID of the user assigned to the task

deadlinestring date

The date by which the task must be completed

Example request

{
  "taskName": "Complete security review",
  "description": "Review security controls and document findings",
  "assigneeId": "123e4567-e89b-12d3-a456-426614174000",
  "deadline": "2025-12-31",
  "collaborators": [
    {
      "collaboratorId": "123e4567-e89b-12d3-a456-426614174000",
      "collaboratorEmail": "collaborator@example.com",
      "type": "USER"
    }
  ]
}

Response

Created

string uuid required