---
title: "Boostrap Seasonality URL"
method: POST
path: "/forecaster/auto-seasonality/ingest-url"
tags: ["Auto Seasonality"]
---

# Boostrap Seasonality URL

`POST /forecaster/auto-seasonality/ingest-url`

## Request

- Base URL: `https://api.kevel.co/v1`
- URL: `https://api.kevel.co/v1/forecaster/auto-seasonality/ingest-url`
- Auth: API key in header `X-Adzerk-ApiKey`

This endpoint allows you to bootstrap auto seasonality, by uploading a `*.csv` file directly to Kevel Forecast.
When you create a new ingest URL, we'll give you back a signed URL to upload the file to.

The file needs to be in CSV format, containing the total events per day with the following format, where:

* `events`: the total number of events for a given day.
* `site:<ID>`: the total number of events for a specific site where `<ID>` is the the Kevel's Site identifier.

```csv
date,events,site:4572,site:7643
2025-01-01,236632,206845,29787
2025-01-02,690062,288547,401515
```

Kevel Forecast requires 13 months of data for the boostrap.

See [Auto Seasonality](ref:auto-seasonality) for more details on this feature.

## Request body

- object
  - `filename` string: The name of the file to be pushed to the ingest URL.

## Response `200`

Normal response, containing a JSON object with the signed Amazon S3 URL

- object
  - `url` string: The signed URL for the Amazon S3 Bucket to where the file can be uploaded
  - `status` string: A fully-formed URL you can `GET` to track the ingestion status of this upload. The URL points at `/forecaster/auto-seasonality/ingest-status` with the appropriate `file` query parameter already filled in.

---

[API](https://skmtc.dev/kevel/apis/forecast-api.md) - [All operations](https://skmtc.dev/kevel/apis/forecast-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kevel/apis/forecast-api/revisions/f07c8784a32d?raw)