Batch Sync Assignments

post

/api/restapi/assignment/syncBatch

Send a request to this endpoint to create or update one or more assignments.

Request

Header Parameters
  • Enabling this boolean flag fails to complete the request if an error occurred when processing any assignment sent as part of the request.
    Allowed Values: [ "true", "false" ].
    Default Value: false
Supported Media Types
Request Body - application/json ()
Root Schema : List<ApiEntityAssignment>
Type: array
Title: List<ApiEntityAssignment>
Show Source
  • ApiEntityAssignment
    Title: ApiEntityAssignment
    This entity represents a Assignment object, a unique Assignment object can be identified by the following combinations of the fields.
    • assignmentId
    • activityId,resourceId,assignmentCode
    • activityCode,projectCode,workspaceCode,resourceId,assignmentCode
    • activityId,workspaceCode,resourceCode,resourceClass,assignmentCode
    • activityCode,projectCode,workspaceCode,resourceCode,resourceClass,assignmentCode
Nested Schema : ApiEntityAssignment
Type: object
Title: ApiEntityAssignment
This entity represents a Assignment object, a unique Assignment object can be identified by the following combinations of the fields.
  • assignmentId
  • activityId,resourceId,assignmentCode
  • activityCode,projectCode,workspaceCode,resourceId,assignmentCode
  • activityId,workspaceCode,resourceCode,resourceClass,assignmentCode
  • activityCode,projectCode,workspaceCode,resourceCode,resourceClass,assignmentCode
Show Source
Nested Schema : assignmentFinancial
List all assignment cost field spread data assigned to the assignment.
Match All
Show Source
Nested Schema : configuredFields
Type: array
The list of configured fields for an assignment.
Show Source
  • ApiEntityAssignmentConfiguredFieldValue
    Title: ApiEntityAssignmentConfiguredFieldValue
    This entity represents a AssignmentConfiguredFieldValue object, a unique AssignmentConfiguredFieldValue object can be identified by the following combinations of the fields.
    • assignmentConfiguredFieldValueId
    • columnDefinitionId
    • columnName
    • columnLabel
Nested Schema : resourceCurve
The resource's units and costs distributed over the duration of an activity.
Match All
Show Source
Nested Schema : ApiEntityAssignmentFinancial
Type: object
Title: ApiEntityAssignmentFinancial
Show Source
  • The system-generated identifier of an activity.
  • The actual cost for the resource assignment on the activity. This field is in base currency and is calculated from actualCostProject field based on the specified exchange rate.
  • The actual cost for the resource assignment on the activity. This value is based on the project currency.
  • The labor, nonlabor, and material costs incurred during the current financial period. This field is in base currency and is calculated from actualThisPeriodCostProject field based on the specified exchange rate.
  • The labor, nonlabor, and material costs incurred during the current financial period. This value is based on the project currency.
  • The unique identifier for the assignment.
  • The unique identifier for the assignment.
  • The sum of the actual costs plus remaining costs for the resource assignment on the activity. This field is in base currency and is calculated from atCompletionCostProject field based on the specified exchange rate.
  • The sum of the actual costs plus remaining costs for the resource assignment on the activity. This value is based on the project currency.
  • Read Only: true
    The remaining cost for resource assignments that have a filled role. This field is in base currency and is calculated from earnedValueCostProject field based on the specified exchange rate.
  • Read Only: true
    The approved budget for work actually completed by the specified project data date. This value is based on the project currency.
  • The expected total cost of the item, such as an assignment, expense, or response plan. This field is in base currency and is calculated from plannedCostProject field based on the specified exchange rate.
  • The expected total cost of the item, such as an assignment, expense, or response plan. This value is based on the project currency.
  • Read Only: true
    The amount of approved capital spent on a scheduled portion of work on a project. This field is in base currency and is calculated from plannedValueCostProject field based on the specified exchange rate.
  • Read Only: true
    The amount of approved capital spent on a scheduled portion of work on a project. This value is based on the project currency.
  • Minimum Value: 0
    The price per unit of time for the resource or role. This field is in base currency and is calculated from pricePerUnitProject field based on the specified exchange rate.
  • Minimum Value: 0
    The price per unit of time for the resource or role. This value is based on the project currency.
  • Read Only: true
    The total actual costs incurred at the time of the last stored period performance. This field is in base currency and is calculated from priorActualCostProject field based on the specified exchange rate.
  • Read Only: true
    The total actual costs incurred at the time of the last stored period performance. This value is based on the project currency.
  • The system-generated identifier of a project.
  • The remaining cost for the activity resource assignment. Calculated as Remaining Units multiplied by Cost/Time. This field is in base currency and is calculated from remainingCostProject field based on the specified exchange rate.
  • The remaining cost for the resource assignment on the activity. This value is based on the project currency.
  • The system-generated identifier of a resource.
  • Read Only: true
    The remaining cost for resource assignments that have a filled role. This field is in base currency and is calculated from staffedRemainingCostProject field based on the specified exchange rate.
  • Read Only: true
    The remaining cost for resource assignments that have a filled role. This value is based on the project currency.
  • Read Only: true
    The remaining cost for resource assignments that do not have a filled role. This field is in base currency and is calculated from unstaffedRemainingCostProject field based on the specified exchange rate.
  • Read Only: true
    The remaining cost for resource assignments that do not have a filled role. This value is based on the project currency.
  • Read Only: true
    Date when the record was last updated.
Nested Schema : ApiEntityAssignmentConfiguredFieldValue
Type: object
Title: ApiEntityAssignmentConfiguredFieldValue
This entity represents a AssignmentConfiguredFieldValue object, a unique AssignmentConfiguredFieldValue object can be identified by the following combinations of the fields.
  • assignmentConfiguredFieldValueId
  • columnDefinitionId
  • columnName
  • columnLabel
Show Source
Nested Schema : ApiEntityCurve
Type: object
Title: ApiEntityCurve
Show Source
Nested Schema : buckets
Type: array
The buckets of a cost curve.
Show Source
Nested Schema : ApiEntityCurveBucket
Type: object
Title: ApiEntityCurveBucket
Show Source
Examples

Back to Top

Response

Supported Media Types

207 Response

The object was successfully integrated.
Body ()
Root Schema : List<ApiEntitySyncApiResponse>
Type: array
Title: List<ApiEntitySyncApiResponse>
Show Source
Nested Schema : ApiEntitySyncApiResponse
Type: object
Title: ApiEntitySyncApiResponse
Show Source
  • identifier
    The unique identifier of the supported object returned based on the user input.
    This field can return any of the following entities determined based on the object for which the API call is invoked.
    Example : RiskScoreTypeIdentifier is returned when Batch Sync Risk Score Types API is invoked.
  • Error message or reason for operation failure is populated. The field is non-persistable and thus maximum length is not applicable.
  • The response code representing the state of the API operation.
Nested Schema : identifier
Type: object
The unique identifier of the supported object returned based on the user input.
This field can return any of the following entities determined based on the object for which the API call is invoked.
Example : RiskScoreTypeIdentifier is returned when Batch Sync Risk Score Types API is invoked.
Match One Schema
Show Source
Nested Schema : ConstraintIdentifier
Type: object
Title: ConstraintIdentifier
Show Source
Nested Schema : CBSSheetSegmentIdentifier
Type: object
Title: CBSSheetSegmentIdentifier
Show Source
Nested Schema : CBSTemplateSegmentIdentifier
Type: object
Title: CBSTemplateSegmentIdentifier
Show Source
Nested Schema : ScopeAssignmentActualsTimePhasedDataIdentifier
Type: object
Title: ScopeAssignmentActualsTimePhasedDataIdentifier
Show Source
Nested Schema : ScopeAssignmentInstalledTimePhasedDataIdentifier
Type: object
Title: ScopeAssignmentInstalledTimePhasedDataIdentifier
Show Source
Nested Schema : ResourceWorkRateIdentifier
Type: object
Title: ResourceWorkRateIdentifier
Show Source
Nested Schema : ReasonIdentifier
Type: object
Title: ReasonIdentifier
Show Source
Nested Schema : WorkManagerTaskIdentifier
Type: object
Title: WorkManagerTaskIdentifier
Show Source
Nested Schema : ChangeRequestIdentifier
Type: object
Title: ChangeRequestIdentifier
Show Source
Nested Schema : ScopeItemAssignmentActivityIdentifier
Type: object
Title: ScopeItemAssignmentActivityIdentifier
Show Source
Nested Schema : RiskScoreTypeIdentifier
Type: object
Title: RiskScoreTypeIdentifier
Show Source
Nested Schema : RiskMatrixIdentifier
Type: object
Title: RiskMatrixIdentifier
Show Source
Nested Schema : ProjectRiskIdentifier
Type: object
Title: ProjectRiskIdentifier
Show Source
Nested Schema : ProgramRiskIdentifier
Type: object
Title: ProgramRiskIdentifier
Show Source
Nested Schema : ActivityRiskIdentifier
Type: object
Title: ActivityRiskIdentifier
Show Source
Nested Schema : RiskMitigationIdentifier
Type: object
Title: RiskMitigationIdentifier
Show Source
Nested Schema : ProgramRiskMitigationIdentifier
Type: object
Title: ProgramRiskMitigationIdentifier
Show Source
Nested Schema : ProgramRiskWeatherPeriodIdentifier
Type: object
Title: ProgramRiskWeatherPeriodIdentifier
Show Source
Nested Schema : HolidayGroupIdentifier
Type: object
Title: HolidayGroupIdentifier
Show Source
Nested Schema : RiskWeatherPeriodIdentifier
Type: object
Title: RiskWeatherPeriodIdentifier
Show Source
Nested Schema : PortfolioIdentifier
Type: object
Title: PortfolioIdentifier
Show Source
Nested Schema : PortfolioMeasureIdentifier
Type: object
Title: PortfolioMeasureIdentifier
Show Source
Nested Schema : EntityReferenceIdentifier
Type: object
Title: EntityReferenceIdentifier
Show Source
Nested Schema : PortfolioMeasureManualValueIdentifier
Type: object
Title: PortfolioMeasureManualValueIdentifier
Show Source
Nested Schema : CustomLogTypeObjectIdentifier
Type: object
Title: CustomLogTypeObjectIdentifier
Show Source
Nested Schema : CustomLogItemIdentifier
Type: object
Title: CustomLogItemIdentifier
Show Source
Nested Schema : ProjectRankIdentifier
Type: object
Title: ProjectRankIdentifier
Show Source
Nested Schema : ProjectDependencyIdentifier
Type: object
Title: ProjectDependencyIdentifier
Show Source
Nested Schema : LocationIdentifier
Type: object
Title: LocationIdentifier
Show Source
Nested Schema : MeasureIdentifier
Type: object
Title: MeasureIdentifier
Show Source
Nested Schema : MeasureThresholdIdentifier
Type: object
Title: MeasureThresholdIdentifier
Show Source
Nested Schema : ReportCycleIdentifier
Type: object
Title: ReportCycleIdentifier
Show Source
Nested Schema : UnitsOfMeasureIdentifier
Type: object
Title: UnitsOfMeasureIdentifier
Show Source
Nested Schema : WorkspaceIdentifier
Type: object
Title: WorkspaceIdentifier
Show Source
Nested Schema : ApplicationUserGroupIdentifier
Type: object
Title: ApplicationUserGroupIdentifier
Show Source
Nested Schema : CalendarIdentifier
Type: object
Title: CalendarIdentifier
Show Source
Nested Schema : CodeTypeIdentifier
Type: object
Title: CodeTypeIdentifier
Show Source
Nested Schema : CodeValueIdentifier
Type: object
Title: CodeValueIdentifier
Show Source
Nested Schema : CostCategoryIdentifier
Type: object
Title: CostCategoryIdentifier
Show Source
Nested Schema : CurveIdentifier
Type: object
Title: CurveIdentifier
Show Source
Nested Schema : DocumentFolderStructureTemplateIdentifier
Type: object
Title: DocumentFolderStructureTemplateIdentifier
Show Source
Nested Schema : IdeaIdentifier
Type: object
Title: IdeaIdentifier
Show Source
Nested Schema : OfficeIdentifier
Type: object
Title: OfficeIdentifier
Show Source
Nested Schema : ProjectCompanyIdentifier
Type: object
Title: ProjectCompanyIdentifier
Show Source
Nested Schema : ResourceDemandIdentifier
Type: object
Title: ResourceDemandIdentifier
Show Source
Nested Schema : ProjectBudgetChangeIdentifier
Type: object
Title: ProjectBudgetChangeIdentifier
Show Source
Nested Schema : ProjectBudgetTransferIdentifier
Type: object
Title: ProjectBudgetTransferIdentifier
Show Source
Nested Schema : ProjectResourceWorkRateIdentifier
Type: object
Title: ProjectResourceWorkRateIdentifier
Show Source
Nested Schema : ProjectActualsLineItemIdentifier
Type: object
Title: ProjectActualsLineItemIdentifier
Show Source
Nested Schema : ProjectActualsIdentifier
Type: object
Title: ProjectActualsIdentifier
Show Source
Nested Schema : ProjectBudgetItemIdentifier
Type: object
Title: ProjectBudgetItemIdentifier
Show Source
Nested Schema : ProgramIdentifier
Type: object
Title: ProgramIdentifier
Show Source
Nested Schema : StrategyIdentifier
Type: object
Title: StrategyIdentifier
Show Source
Nested Schema : StrategyTypeIdentifier
Type: object
Title: StrategyTypeIdentifier
Show Source
Nested Schema : RuleOfCreditIdentifier
Type: object
Title: RuleOfCreditIdentifier
Show Source
Nested Schema : ResourceRoleAssignmentIdentifier
Type: object
Title: ResourceRoleAssignmentIdentifier
Show Source
Nested Schema : BudgetPlanningScenarioIdentifier
Type: object
Title: BudgetPlanningScenarioIdentifier
Show Source
  • The period during which budget is allocated to projects within the plan.
    This value determines the year in which budget planning timescales start.
    You can set the planning period to either the current or following year. For example, if the year is 2020 the latest planning period you can set is 2021.
    After the planning period for a budget plan has been set it cannot be changed.
  • The system-generated identifier of a portfolio. This value should not be provided in create operation request data, however, it is required for update requests.
  • Maximum Length: 255
    The name of the portfolio.
  • The system-generated identifier of the Budget Plan Scenario.
  • Maximum Length: 255
    The name of Budget Plan Scenario.
  • The user-specified identifier of a workspace.
Nested Schema : ScopeAssignmentPlannedTimePhasedDataIdentifier
Type: object
Title: ScopeAssignmentPlannedTimePhasedDataIdentifier
Show Source
Nested Schema : ProgramBudgetTransferIdentifier
Type: object
Title: ProgramBudgetTransferIdentifier
Show Source
Nested Schema : ProgramBudgetChangeIdentifier
Type: object
Title: ProgramBudgetChangeIdentifier
Show Source
Nested Schema : ActivityIdentifier
Type: object
Title: ActivityIdentifier
Show Source
Nested Schema : AssignmentIdentifier
Type: object
Title: AssignmentIdentifier
Show Source
Nested Schema : RelationshipIdentifier
Type: object
Title: RelationshipIdentifier
Show Source
Nested Schema : FundActualIdentifier
Type: object
Title: FundActualIdentifier
Show Source
Nested Schema : ProgramBudgetItemIdentifier
Type: object
Title: ProgramBudgetItemIdentifier
Show Source
Nested Schema : parentCVCodes
Type: array
List of parent code values in a hierarchy. This field is not populated as part of the API response since it is a write-only field, used only for the create or update APIs.
Show Source

400 Response

Invalid input for the Assignment service.
Back to Top