Task Assignee

Create Or Update TaskAssignee

PUT

Adds or updates a TaskAssignee to a Task. If the TaskAssignee is already assigned to the Task, update their allocation. If the TaskAssignee is not yet assigned to the Task, assign them and set their allocation level to the correct amount.

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

Path parameters

taskIdstringRequired
The unique identifier of the Task to add or update an assignment

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
PUT
1curl -X PUT /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
Updated
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}