TaskStartConfigDto - SodiumHQ API Schema

Configuration for when a recurring task should start.
Different properties are required based on the Type value:

SpecificDate: Date specifies the start date seed
WeekDay: Day specifies which day of the week to run on, Date the day the cycle counts from
MonthDay: WeekDayPatterns specifies positional patterns like "First Monday"
ClientDate: ClientDateType (or CustomFieldDefinitionCode), Timing, OffsetDays, OffsetMonths
RelativeToDue: Start derives from Due via Interval (Due-driven mode)

Properties

Name	Type	Description
type	enum	SpecificDate WeekDay MonthDay ClientDate RelativeToDue Sequence
SpecificDate WeekDay MonthDay ClientDate RelativeToDue Sequence
interval	RelativeIntervalDto
weekDayPatterns	array of WeekDayPatternDto	Positional weekday patterns. Required when Type is MonthDay. Example: [{ Position: "First", Day: "Monday" }, { Position: "Last", Day: "Friday" }]
Positional weekday patterns. Required when Type is MonthDay. Example: [{ Position: "First", Day: "Monday" }, { Position: "Last", Day: "Friday" }]
daysOfMonth	array of integer	Days of month (1-31). Used when Type is SpecificDate. Example: [1, 15] for 1st and 15th
Days of month (1-31). Used when Type is SpecificDate. Example: [1, 15] for 1st and 15th
day	enum	Workday Monday Tuesday Wednesday Thursday Friday Saturday Sunday
Workday Monday Tuesday Wednesday Thursday Friday Saturday Sunday
clientDateSourceType	enum	KeyDate CustomField
KeyDate CustomField
clientDateType	enum	IncorporationDate YearEnd AccountsNextDue AccountsNextPeriodStart AccountsNextPeriodEnd AccountsLastPeriodFiled AccountsLastPeriodStart AccountsLastPeriodEnd AccountsLastMadeUpTo ConfirmationStatementDue ConfirmationStatementNextMadeUpTo LastConfirmationStatementFiled LastConfirmationStatementMadeUpTo NextVatReturnDueAnnual NextVatPeriodEndQuarterly NextVatReturnDueQuarterly NextVatPeriodEndMonthly NextVatReturnDueMonthly NextTaxQuarterPeriodEnd NextTaxQuarterSubmissionDeadline NextPayeCisFilingDue PensionReEnrolmentDate CharityAnnualReturnDue CharityAccountsDue CharityLastAnnualReturnReceived CharityLastAccountsReceived CharityFinancialYearEnd
IncorporationDate YearEnd AccountsNextDue AccountsNextPeriodStart AccountsNextPeriodEnd AccountsLastPeriodFiled AccountsLastPeriodStart AccountsLastPeriodEnd AccountsLastMadeUpTo ConfirmationStatementDue ConfirmationStatementNextMadeUpTo LastConfirmationStatementFiled LastConfirmationStatementMadeUpTo NextVatReturnDueAnnual NextVatPeriodEndQuarterly NextVatReturnDueQuarterly NextVatPeriodEndMonthly NextVatReturnDueMonthly NextTaxQuarterPeriodEnd NextTaxQuarterSubmissionDeadline NextPayeCisFilingDue PensionReEnrolmentDate CharityAnnualReturnDue CharityAccountsDue CharityLastAnnualReturnReceived CharityLastAccountsReceived CharityFinancialYearEnd
customFieldDefinitionCode	string	The code of the custom field definition. Required when Type is ClientDate and ClientDateSourceType is CustomField. Only DATE-type custom fields are valid.
The code of the custom field definition. Required when Type is ClientDate and ClientDateSourceType is CustomField. Only DATE-type custom fields are valid.
customFieldDefinitionLabel	string	The label of the custom field definition. Populated in responses only.
The label of the custom field definition. Populated in responses only.
timing	enum	OnActualDate DaysBefore DaysAfter
OnActualDate DaysBefore DaysAfter
offsetDays	integer	The number of days before or after the client date. Used when Type is ClientDate and Timing is DaysBefore or DaysAfter. Paired with OffsetMonths for composite offsets like "1 month + 7 days".
The number of days before or after the client date. Used when Type is ClientDate and Timing is DaysBefore or DaysAfter. Paired with OffsetMonths for composite offsets like "1 month + 7 days".
offsetMonths	integer	The number of months before or after the client date. Paired with OffsetDays. NULL when no months portion is needed. Used when Type is ClientDate.
The number of months before or after the client date. Paired with OffsetDays. NULL when no months portion is needed. Used when Type is ClientDate.
date	string	Specific start date. Used when Type is SpecificDate. This is when the recurring task should first start generating tasks.
Specific start date. Used when Type is SpecificDate. This is when the recurring task should first start generating tasks.
sequenceSeedDate	string	The first Start date of the repeating pattern (the cycle seed). Required when Type is Sequence; pairs with Recurrence.Sequence exactly as on the Due and Statutory sides.
The first Start date of the repeating pattern (the cycle seed). Required when Type is Sequence; pairs with Recurrence.Sequence exactly as on the Due and Statutory sides.
holidayAdjustment	enum	None Skip MoveBefore MoveAfter
None Skip MoveBefore MoveAfter
time	string	Time of day stamped onto every projected Start date. Omit for 09:00; always populated in responses.
Time of day stamped onto every projected Start date. Omit for 09:00; always populated in responses.

JSON Example

{
  "type": "SpecificDate",
  "interval": {
    "value": 0,
    "unit": "..."
  },
  "weekDayPatterns": [
    {
      "position": "...",
      "day": "..."
    }
  ],
  "daysOfMonth": [
    0
  ],
  "day": "Workday"
}

Contained in Schemas

ScheduleConfigDto Groups all scheduling configuration for a recurring task template: which date drives the cycle, how ...