Allocates a person to a task role on the given account and project

A person cannot be allocated entirely inside a period of unavailability and cannot be allocated outside of their employment dates.

For allocations that overlap a period of unavailability, the API will truncate or not set the date range that the person is unavailable.

Examples: Unavailable from 2020-01-11 to 2020-01-25, Allocation date from 2020-01-20 to 2020-03-31, will alocate the person from 2020-01-26 to 2020-03-31

Unavailable from 2020-01-11 to 2020-01-25, Allocation date from 2020-01-01 to 2020-03-31, will alocate the person from 2020-01-01 to 2020-01-10 AND 2020-01-26 to 2020-03-31
Permissions
Project: Read
Person: Read
Role: Read
Allocation: Write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required

The Account ID

int64
required

The project ID

uuid
required

The task ID

int64
required

The role ID the task role belongs to

Body Params

Request object containing the person to allocate

int64
required
date-time
required
date-time
required
date-time | null

Optional. When provided, updates the unfilled role's start date before creating the allocation.
Must be set together with ResourcePlanning.Contracts.TaskAllocationRequest.RoleEndDate — supplying only one will fail validation.

date-time | null

Optional. When provided, updates the unfilled role's end date before creating the allocation.
Must be set together with ResourcePlanning.Contracts.TaskAllocationRequest.RoleStartDate — supplying only one will fail validation.

Headers
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses
204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

409

Conflict

422

Unprocessable Entity

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here!