Skip to main content

Tasks

📄️Create Analytic Task

Creates an Analyze, Extract, or Replication task. For Analyze, `analyticGroupId` selects the calculation steps and `processedDataSchema` specifies the destination schema. Analyze and Extract require `dataStrategyId` and `sqlDatabaseCredentialId`; Replication requires exactly one destination connection ID, `replicationDataStrategy`, and `extractedDataSchema` when replicating to Snowflake or Microsoft Fabric Mirror. Supply SAP credential assignments for source systems; Extract and Replication also use extraction package assignments. Once is valid when creating a task. For recurring schedules, Hourly `runEvery` is 1–23, Daily is 1–6, and Monthly is 1–12; Weekly `scheduleDays` are 0–6, while Monthly days are 1–28 or -1 for the last day. Real-Time accepts an optional `realTimeDelayInMinutes` of 1–59. Other recurring schedules require a future local `startTime` and `timeZoneId`. When supplied, `startTime` is automatically rounded up to the next 15-minute boundary; values already on a boundary are unchanged. Invalid request fields or schedule values return 400. Replace the example GUIDs with IDs of existing resources before sending a request.

📄️Update Task Start Time by ID

Updates only the scheduled `startTime` and `timeZoneId` for the specified task; use UpdateTaskSchedule to edit recurrence. `startTime` must be a future local ISO 8601 date and time, such as 2030-01-15T09:30:00; `timeZoneId` identifies the IANA time zone used to interpret it, such as Europe/Berlin. The public API automatically rounds `startTime` up to the next 15-minute boundary; values already on a boundary are unchanged. Invalid times or time zones return 400; unknown task IDs return 404.

📄️Update Task Schedule by ID

Updates recurrence settings only; this operation does not change `startTime` or `timeZoneId` (use UpdateTaskStartTime). Valid targets are Hourly, Daily, Weekly, Monthly, and RealTime; Once is not an update target. Use positive `runEvery` values for Hourly, Daily, or Monthly schedules; `scheduleDays` uses 0–6 for Weekly or 1–28 and -1 for the last day for Monthly. `realTimeDelayInMinutes` is optional (1–59) and can be changed in place for an existing RealTime task, but transitions to or from RealTime are rejected. Invalid values or transitions return 400; unknown task IDs return 404.