Delete Configuration
DELETE/api/inventory-forecasting/configurations/:configuration
Delete a forecast configuration.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Returns 200 on success. Returns 422 if the configuration is in use by schedules and force is not true.
When the configuration is in use and force=true is sent, the configuration is deleted and every schedule that used it is turned off, so none of them fails on its next run. The 200 response lists those schedules in data.disabled_schedules (each with id and name) and the message names them; edit each schedule to choose another configuration, then turn it back on. When no schedule used the configuration, disabled_schedules is empty.
Make / buy / transfer plans: warehouse_ids (integer[]), horizon_days (integer 7–365, default 90) and include_make (boolean) save a unified plan's scope. A configuration with warehouses (or no suppliers, or include_make true) runs as a make / buy / transfer plan — supplier_ids then becomes an optional filter and may be empty. One with suppliers and no warehouses stays a per-supplier purchase forecast. Schedules running a plan configuration build the plan and, when they auto-create, raise purchase orders only.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.