v2

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-07-21130282381.6 KB
APIs

Migrate an API

Migrate an API

⚠️ Experimental endpoints - subject to change Migrate an APIv2 to APIv4.

High risk operation: require explicit user confirmation before execution.

post/environments/{envId}/apis/{apiId}/_migrate

Response

Migration report

state'MIGRATED' | 'MIGRATABLE' | 'CAN_BE_FORCED' | 'IMPOSSIBLE'
  • MIGRATED: API is migrated
  • MIGRATABLE: DRY_RUN and can works
  • CAN_BE_FORCED: if you force, we upgrade
  • IMPOSSIBLE: we don’t know howto upgrade