Skip to navigation
API ReferenceTask Assignee

Replace Task Assignees

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.

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 whose TaskAssignees will be replaced

Headers

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

Request

The new list of TaskAssignees for this Task
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