Task Assignee

Replace Task Assignees

POST

Replace all TaskAssignees on a Task with new TaskAssignees.

A TaskAssignee is an assignment of a Resource to a Task. You can assign multiple Resources to a Task and designate how much of their time will be allocated to this Task.

In the request body, id is the id of the Resource you would like to assign to the Task, and assignedEffort is the amount of time that Resource is expected to spend on the task. assignedEffort should be entered in minutes.

Path parameters

taskIdstringRequired
The unique identifier of the Task whose TaskAssignees will be replaced

Request

This endpoint expects a list of objects.
id
stringRequired
The unique identifier of the TaskAssignee to which work is being assigned.
assignedEffort
integerOptional
The new amount of effort to assign for this Resource. This value is measured in minutes.

Response

This endpoint returns an object
error
objectOptional
If the API call failed, this will contain information about the error that occurred.
success
booleanOptional
True if the API call succeeded; false otherwise.
hasError
booleanOptional
True if the API call failed.
statusCode
enumOptional
The HTTP code of the response.
data
objectOptional
Returns the id of a specific ChangeSet
POST
1curl -X POST /api/data/tasks/taskId/assignees \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '[
5 {
6 "id": "id"
7 }
8]'
200
Successful
1{
2 "error": {
3 "technicalError": "technicalError",
4 "additionalErrors": [
5 "additionalErrors"
6 ],
7 "message": "message"
8 },
9 "success": true,
10 "hasError": true,
11 "statusCode": "Continue",
12 "data": {
13 "changeSetId": "changeSetId",
14 "id": "id"
15 }
16}