Update Allocation

curl --request PUT \
  --url https://planner.svc.v2.projectcor.com/allocation/updateAllocation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "oldAllocation": {
    "userId": 1111,
    "companyId": 11,
    "resource": {
      "entityId": 11111,
      "typeId": "Project"
    },
    "from": "2024-01-01",
    "to": "2024-03-31",
    "assignedByUserId": 1111,
    "allocatedHours": 0
  },
  "newAllocation": {
    "userId": 1111,
    "companyId": 11,
    "resource": {
      "entityId": 11111,
      "typeId": "Project"
    },
    "from": "2024-01-01",
    "to": "2024-03-31",
    "assignedByUserId": 1111,
    "allocatedHours": 10
  }
}
'

{
  "error": "AllocationNotFoundError",
  "message": "The specified allocation cannot be found"
}

Allocations

Update Allocation

Updates an existing resource allocation. Requires both the old allocation data and the new allocation data.

Known Errors:

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

Note: You can use this endpoint to change a project allocation, as long as there isn’t an existing allocation for the same user in the target project for any date within the range of the new allocation.

PUT

allocation

updateAllocation

Update Allocation

curl --request PUT \
  --url https://planner.svc.v2.projectcor.com/allocation/updateAllocation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "oldAllocation": {
    "userId": 1111,
    "companyId": 11,
    "resource": {
      "entityId": 11111,
      "typeId": "Project"
    },
    "from": "2024-01-01",
    "to": "2024-03-31",
    "assignedByUserId": 1111,
    "allocatedHours": 0
  },
  "newAllocation": {
    "userId": 1111,
    "companyId": 11,
    "resource": {
      "entityId": 11111,
      "typeId": "Project"
    },
    "from": "2024-01-01",
    "to": "2024-03-31",
    "assignedByUserId": 1111,
    "allocatedHours": 10
  }
}
'

{
  "error": "AllocationNotFoundError",
  "message": "The specified allocation cannot be found"
}

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

oldAllocation

object

required

The existing allocation to be updated

Show child attributes

newAllocation

object

required

The new allocation data

Show child attributes

Response

Allocation updated successfully

Save Allocation Delete Allocation

⌘I