Save Allocation

curl --request POST \
  --url https://planner.svc.v2.projectcor.com/allocation/saveAllocation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": 1111,
  "companyId": 1111,
  "email": "email@email.com",
  "resource": {
    "typeId": "Project",
    "entityId": 1111
  },
  "from": "2024-06-01",
  "to": "2024-10-31",
  "assignedByUserId": 11111,
  "allocatedHours": 20
}
'

Allocations

Save Allocation

Creates a new resource allocation for a user on a project.

Request Body Requirements: All values in the object are required.

Known Errors:

InvalidAllocationError — The allocation is invalid:
- Empty allocatedHours field
- The from date is greater than or equal to the to date
- The date range exceeds 12 months
AllocationAlreadyExistInDatesRangeError — An allocation already exists within the specified date range
UserNotFoundError — The specified user cannot be found
UserNotHaveWorkDaysError — The user does not have any work days configured
ProjectNotFoundError — The specified project cannot be found

POST

allocation

saveAllocation

Save Allocation

curl --request POST \
  --url https://planner.svc.v2.projectcor.com/allocation/saveAllocation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": 1111,
  "companyId": 1111,
  "email": "email@email.com",
  "resource": {
    "typeId": "Project",
    "entityId": 1111
  },
  "from": "2024-06-01",
  "to": "2024-10-31",
  "assignedByUserId": 11111,
  "allocatedHours": 20
}
'

Authorizations

Authorization

string

header

required

Uses the same authentication as the main COR API. Obtain a token from https://api.projectcor.com/v1/oauth/token

Body

application/json

userId

integer

required

ID of the user being allocated

companyId

integer

required

Company ID

resource

object

required

Show child attributes

from

string<date>

required

Start date (YYYY-MM-DD)

string<date>

required

End date (YYYY-MM-DD). Must be after 'from' date and within 12 months.

assignedByUserId

integer

required

ID of the user who assigned the allocation

allocatedHours

number

required

Number of hours allocated

string<email>

User email (optional)

Response

Allocation saved successfully

Resource Allocation Update Allocation

⌘I