Train Model

Train an existing forecast model.

Train Model

post

Triggers training for the specified forecast model. The model must have demand data uploaded and be in a state that allows training (e.g. ready or created with demand data).

Training runs asynchronously — poll the model's readiness.status field to monitor progress.

Authorizations

BearerAuth

AuthorizationstringRequired

Enter your PredictHQ API key. The Bearer prefix is added automatically.

When calling the API directly, send: Authorization: Bearer <YOUR_API_KEY> as documented at https://docs.predicthq.com/api/overview/authenticating

Path parameters

model_idstringRequired

The unique identifier of the forecast model.

Responses

204

Successful Response

No content

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

post/v1/forecasts/models/{model_id}/train

HTTPcURLJavaScriptPython

POST /v1/forecasts/models/{model_id}/train HTTP/1.1
Host: api.predicthq.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

OpenAPI Spec

The OpenAPI spec for Forecasts API can be found here.

Guides

• Getting Started with Forecasts API
• Understanding Forecast Accuracy Metrics
• Troubleshooting Guide for Forecasts API