Batch Sync Calendars

post

/api/restapi/calendar/syncBatch

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

Request

Header Parameters
  • Enabling this boolean flag will fail the request if an error occurs while processing any calendar sent as part of the request.
    Allowed Values: [ "true", "false" ]
    Default Value: false
Supported Media Types
Request Body - application/json ()
Root Schema : List<ApiEntityCalendarInput>
Type: array
Title: List<ApiEntityCalendarInput>
Show Source
  • ApiEntityCalendarInput
    Title: ApiEntityCalendarInput
    This entity represents a Calendar object, a unique Calendar object can be identified by the following combinations of the fields.
    • calendarId
    • calendarCode,workspaceId
    • calendarCode,workspaceCode
    • calendarCode,projectId
    • calendarCode,projectCode,workspaceCode
    • calendarCode,projectCode,workspaceId
Nested Schema : ApiEntityCalendarInput
Type: object
Title: ApiEntityCalendarInput
This entity represents a Calendar object, a unique Calendar object can be identified by the following combinations of the fields.
  • calendarId
  • calendarCode,workspaceId
  • calendarCode,workspaceCode
  • calendarCode,projectId
  • calendarCode,projectCode,workspaceCode
  • calendarCode,projectCode,workspaceId
Show Source
  • Read Only: true
    Allowed Values: [ "OWNED", "INHERITED" ]
    Deprecated. As of 24.4.
    The type of association in the relationship between the calendar and the workspace. Possible values are Owned and Inherited.
  • Minimum Length: 0
    Maximum Length: 255
    The unique code for the calendar.
  • calendarExceptions
    Defines exceptions to the specified calendar.
  • The unique identifier for the calendar.
  • Minimum Length: 0
    Maximum Length: 255
    The name of the calendar.
  • The number of hours in a day.
  • The holiday list assigned to the calendar.
  • Allowed Values: [ "NONE", "FORWARD", "BACKWARD", "CLOSEST_WORK_DAY" ]
    Specifies a holiday within calendar work time.
  • Indicates whether or not the calendar can be assigned to a project.
  • Indicates whether or not the calendar can be assigned to a resource.
  • Read Only: true
    Deprecated. As of 24.4.
    The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
  • The number of hours in a month.
  • Minimum Length: 1
    Maximum Length: 60
    The unique identifier for a project set by the user who created the project.
  • The unique identifier for the project.The project object can also be identified by its unique criteria.
  • Allowed Values: [ "MANUAL", "AUTOMATIC" ]
    Specifies how a workspace calendar is shared across child workspaces.
  • Read Only: true
    Deprecated. As of 24.4.
    Date when the record was last updated.
  • The number of hours in a week.
  • Minimum Length: 0
    Maximum Length: 60
    The user-specified identifier of a workspace.
  • The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.
  • Maximum Length: 48
    The working time for Friday.
    The value is a 48 character string, which can either be 0 to indicate non-work time or 1 to indicate work time. Each character in this 48 character string corresponds to a 30 minute slot available in a day. Two slots per hour multiplied by 24 hours equals 48 characters.
    For example, the 1's in the following string indicate that work time for the day is 9 AM to 5 PM.
    000000000000000000111111111111111100000000000000
  • Maximum Length: 48
    The working time for Monday.
    The value is a 48 character string, which can either be 0 to indicate non-work time or 1 to indicate work time. Each character in this 48 character string corresponds to a 30 minute slot available in a day. Two slots per hour multiplied by 24 hours equals 48 characters.
    For example, the 1's in the following string indicate that work time for the day is 9 AM to 5 PM.
    000000000000000000111111111111111100000000000000
  • Maximum Length: 48
    The working time for Saturday.
    The value is a 48 character string, which can either be 0 to indicate non-work time or 1 to indicate work time. Each character in this 48 character string corresponds to a 30 minute slot available in a day. Two slots per hour multiplied by 24 hours equals 48 characters.
    For example, the 1's in the following string indicate that work time for the day is 9 AM to 5 PM.
    000000000000000000111111111111111100000000000000
  • Maximum Length: 48
    The working time for Sunday.
    The value is a 48 character string, which can either be 0 to indicate non-work time or 1 to indicate work time. Each character in this 48 character string corresponds to a 30 minute slot available in a day. Two slots per hour multiplied by 24 hours equals 48 characters.
    For example, the 1's in the following string indicate that work time for the day is 9 AM to 5 PM.
    000000000000000000111111111111111100000000000000
  • Maximum Length: 48
    The working time for Thursday.
    The value is a 48 character string, which can either be 0 to indicate non-work time or 1 to indicate work time. Each character in this 48 character string corresponds to a 30 minute slot available in a day. Two slots per hour multiplied by 24 hours equals 48 characters.
    For example, the 1's in the following string indicate that work time for the day is 9 AM to 5 PM.
    000000000000000000111111111111111100000000000000
  • Maximum Length: 48
    The working time for Tuesday.
    The value is a 48 character string, which can either be 0 to indicate non-work time or 1 to indicate work time. Each character in this 48 character string corresponds to a 30 minute slot available in a day. Two slots per hour multiplied by 24 hours equals 48 characters.
    For example, the 1's in the following string indicate that work time for the day is 9 AM to 5 PM.
    000000000000000000111111111111111100000000000000
  • Maximum Length: 48
    The working time for Wednesday.
    The value is a 48 character string, which can either be 0 to indicate non-work time or 1 to indicate work time. Each character in this 48 character string corresponds to a 30 minute slot available in a day. Two slots per hour multiplied by 24 hours equals 48 characters.
    For example, the 1's in the following string indicate that work time for the day is 9 AM to 5 PM.
    000000000000000000111111111111111100000000000000
  • The number of hours in a year.
Nested Schema : calendarExceptions
Type: array
Defines exceptions to the specified calendar.
Show Source
Nested Schema : ApiEntityCalendarExceptionInput
Type: object
Title: ApiEntityCalendarExceptionInput
Show Source
  • Read Only: true
    Minimum Length: 0
    Maximum Length: 255
    Deprecated. As of 24.4.
    The unique code for the calendar.
  • The unique identifier for the calendar exception.
  • The unique identifier for the calendar.
  • The date that is marked as an exception. An exception is a change to the regularly scheduled time in the calendar.
  • Maximum Length: 60
    The name of the exception for the calendar.
  • Read Only: true
    Deprecated. As of 24.4.
    Date when the record was last updated.
  • Read Only: true
    Minimum Length: 0
    Maximum Length: 60
    Deprecated. As of 24.4.
    The user-specified identifier of a workspace.
  • Maximum Length: 4000
    Work time that is non-standard.
    The value is a 48 character string, which can either be 0 to indicate non-work time or 1 to indicate work time. Each character in this 48 character string corresponds to a 30 minute slot available in a day. Two slots per hour multiplied by 24 hours equals 48 characters.
    For example, the 1's in the following string indicate that work time for the day is 9 AM to 5 PM.
    000000000000000000111111111111111100000000000000
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 calendar service. Verify the request contains valid data, then resubmit the request.
Back to Top