---
title: "Changes to Create migration"
method: POST
path: "/plan-version-migrations"
---

# Changes to Create migration

`POST /plan-version-migrations`

> Every recorded change to this operation, newest first.
> 230 revisions in range; 1 not diffed.

## Timeline

Changed in 7 of 230 revisions.

- **2026-10-01** `af5a1afcf7ff`: 1 warning, 3 info
- **2026-09-15** `1b35e4327220`: 2 info
- **2026-08-24** `54c21fb8a4b7`: 2 warning, 2 info
- **2026-08-18** `82656c1cb6fc`: 1 warning, 1 info
- **2026-08-11** `a1d33706a142`: 3 info
- **2026-08-10** `8b0d50574230`: 2 info
- **2026-05-27** `b059af8ebdc0`: 1 info

## Changes

- **2026-10-01** `af5a1afcf7ff`: 1 warning, 3 info
  - added the new `scheduled` enum value to the `data/strategy` response property for the response status `201`
  - added the new optional request property `scheduled_at`
  - added the new `scheduled` enum value to the request property `strategy`
  - added the optional property `data/scheduled_at` to the response with the `201` status
- **2026-09-15** `1b35e4327220`: 2 info
  - added the optional property `data/feature_id` to the response with the `201` status
  - added the optional property `data/feature_plan_rollout_id` to the response with the `201` status
- **2026-08-24** `54c21fb8a4b7`: 2 warning, 2 info
  - added the new `cancelled` enum value to the `data/status` response property for the response status `201`
  - added the new `end_of_billing_period` enum value to the `data/strategy` response property for the response status `201`
  - added the new `end_of_billing_period` enum value to the request property `strategy`
  - added the optional property `data/next_due_at` to the response with the `201` status
- **2026-08-18** `82656c1cb6fc`: 1 warning, 1 info
  - added the new `none` enum value to the `data/proration_behavior/allOf[#/components/schemas/MigrationProrationBehavior]/` response property for the response status `201`
  - added the new `none` enum value to the request property `proration_behavior/allOf[#/components/schemas/MigrationProrationBehavior]/`
- **2026-08-11** `a1d33706a142`: 3 info
  - the request property `company_ids` became optional
  - the request property `excluded_company_ids` became optional
  - the request property `plan_version_ids_from` became optional
- **2026-08-10** `8b0d50574230`: 2 info
  - added the new optional request property `proration_behavior`
  - added the optional property `data/proration_behavior` to the response with the `201` status
- **2026-05-27** `b059af8ebdc0`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/schematichq/apis/schematic-api/docs/plan-version-migrations/post.md) - [API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [Page](https://skmtc.dev/schematichq/apis/schematic-api/changes/plan-version-migrations/post)