| api-key | Predictr.io API key for authentication | yes | — |
| organisation | Organisation name in Predictr.io | yes | — |
| api-endpoint | Predictr.io API endpoint (e.g., api.predictr.io) | no | api.predictr.io |
| analysis-name | Name for the forecast analysis (must be unique) | yes | — |
| connection-id | Database connection ID in Predictr.io | yes | — |
| table-name | Name of the table containing time series data | yes | — |
| date-column | Name of the date/timestamp column | yes | — |
| value-column | Name of the value column to forecast | yes | — |
| frequency | Time series frequency: D (daily), W (weekly), or h (hourly) | yes | — |
| schema-name | Database schema name (if applicable) | no | — |
| table-filter | JSON array of filter conditions (e.g., [{"feature": "STORE_CODE", "operator": "EQ", "value": "12345"}]) | no | — |
| regressors | Comma-separated list of regressor column names | no | — |
| regressors-future-data | JSON object specifying future regressor data source (e.g., {"table_name": "future_weather", "date_column": "date", "schema_name": "analytics"}) | no | — |
| seasonality | Seasonality type: additive or multiplicative (default: additive) | no | additive |
| holidays | Country code for holiday calendar (e.g., GB, US) | no | — |
| holiday-subdivision | Holiday subdivision/region (e.g., ENG, CA) | no | — |
| observed | Include observed holiday dates (default: true) | no | true |
| events | JSON array of custom events (e.g., [{"event": "Sale", "schedule": [{"ds": "2024-11-24", "duration": 3}]}]) | no | — |
| validation-horizon | Validation horizon in time periods (default: 14) | no | 14 |
| validation-period | Validation period in time periods (default: 14) | no | 14 |
| validation-initial | Initial validation period in time periods (default: 90) | no | 90 |
| fail-if-exists | Fail if analysis with same name already exists (default: false) | no | false |
| fit-model | Immediately fit a model for the analysis (default: true) | no | true |
| model-build-infra | Model build infrastructure: s (small) or l (large) (default: s) | no | s |
| create-workflow | Create a workflow for the analysis (default: false) | no | false |
| workflow-enabled | Enable the workflow immediately (default: false) | no | false |
| forecast-periods | Number of periods to forecast in workflow (default: 14) | no | 14 |
| target-schema | Target schema for forecast predictions in workflow | no | — |
| target-table | Target table for forecast predictions in workflow | no | — |
| include-history | Include historical data in workflow predictions (default: true) | no | true |
| workflow-constants | JSON object of constant values to include in workflow predictions (e.g., {"CONTEXT": "store123"}) | no | — |
| column-mapping | JSON object mapping forecast columns to target table columns (e.g., {"ds": "FORECAST_AT", "yhat": "ESTIMATE"}) | no | — |