API ReferenceTask Assignee

Create Or Update TaskAssignee

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

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

x-integration-namestringOptional

The name of the calling system passed along as a header parameter

Request

This endpoint expects a list of objects.
idstringRequired

The unique identifier of the TaskAssignee to which work is being assigned.

assignedEffortintegerOptional>=0<=2147483647

The new amount of effort to assign for this Resource. This value is measured in minutes.

Response

Success

errorobjectOptional

If the API call failed, this will contain information about the error that occurred.

successbooleanOptional

True if the API call succeeded; false otherwise.

hasErrorbooleanOptional

True if the API call failed.

statusCodeenumOptional

The HTTP code of the response.

dataobjectOptional

Returns the id of a specific ChangeSet