createResourceAssignment

Mutation

Creates a resource assignment for a user or placeholder. Book client work on the client's project: look it up first (getProjects), because it usually exists. Only when the client has no project, propose createProject for the client, then book with its projectId. If the booking fails because the resource is not on the project, add them and book again; never drop projectId to get round it. Add a user with updateProjectMembersPermissions. Add a placeholder with updateProject resourcePlaceholderIds, sending the project's existing IDs plus the new one, because the list is replaced. Defaults are assignmentType regular, allocationType fixedHours, and fixedDisplayType hours. When overriding allocation or display, supply allocationType and fixedDisplayType together as a compatible pair:

• hoursPerDay + hours: set hoursPerDay.
• fixedHours + hours: set fixedHours to total allocated hours.
• fixedHours + days: set fixedHours to requested days times the workspace workday hours.
• fixedHours + percentages: set allocationValue to the percentage; allocated hours are derived across the assignment's working dates. allocationValue is only read in percentages mode; other modes ignore it and recalculate it.

Returns ResourceAssignments .