Skip to navigation
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.

Authentication

AuthorizationBearer

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

Path parameters

taskIdstringRequiredformat: "uuid"
The unique identifier of the Task to add or update an assignment

Headers

x-integration-namestringOptional
The name of the calling system passed along as a header parameter

Request

List of Assignee data
idstringRequiredformat: "uuid"
The unique identifier of the TaskAssignee to which work is being assigned.
assignedEffortinteger or nullOptional0-2147483647

The new amount of effort to assign for this Resource. This value is measured in minutes. If AssignedEffort is null, we try either use the existing AssignedEffort (if there is one), or the Default Planned Effort.

Response

Success
errorobject or nullOptional
If the API call failed, this will contain information about the error that occurred.
successbooleanOptionalRead-only

True if the API call succeeded; false otherwise.

hasErrorbooleanOptionalRead-only
True if the API call failed.
statusCodeenumOptional
The HTTP code of the response.
dataobjectOptional
Returns the id of a specific ChangeSet