POST api/tasks/{projectid}?phase={phase}

Creates a new task under a specified project and optional milestone phase.

Request Information

URI Parameters

Name	Description	Type	Additional information
projectid	The ID of the project under which the task should be created.	integer	Required
phase	Optional milestone phase number. If 0, the first available milestone is used.	integer	Default value is 0

Body Parameters

The task details including name, description, start/end dates, and status.

SDTaskObject

Name	Description	Type	Additional information
name	Name\Title of the task	string	None.
description	Description of the Task	string	None.
status	Status of the Task	string	None.
startDate	Start date for the task	date	None.
endDate	End date for the task, used to calcualte due date	date	None.
projectName	Task Project Name	string	None.
assignedUsers	List of User ID's that this task is assigned to	Collection of integer	None.
assignedGroups	List of Group ID's that this task is assigned to	Collection of integer	None.

Request Formats

application/json, text/json, application/scim+json

Sample:

{
  "name": "sample string 1",
  "description": "sample string 2",
  "status": "sample string 3",
  "startDate": "2025-12-14T16:31:54.053847+00:00",
  "endDate": "2025-12-14T16:31:54.053847+00:00",
  "projectName": "sample string 6",
  "assignedUsers": [
    1,
    2
  ],
  "assignedGroups": [
    1,
    2
  ]
}

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'SDTaskObject'.

Response Information

Resource Description

On success: HTTP 200 OK with the ID of the newly created task. On failure: HTTP 403 Forbidden if access is denied, or HTTP 400 Bad Request if task creation fails.

None.