updated migration-api documentation for subscriptions