How to rename json keys for sdk or api version migration
- Step 1Document the breaking field name changes from the API changelog — Review the new API version's migration guide or changelog to identify every renamed field. Create a mapping list: old field name →’ new field name for each breaking change.
- Step 2Export a sample of existing records — Export a representative JSON sample from your database or data store using the old field names. Verify the sample contains all field variants that appear in production data.
- Step 3Apply the migration mapping — Paste the sample and apply the rename mapping. Verify the output matches the new API schema. Look specifically for any fields that were missed or renamed incorrectly.
- Step 4Script the production migration — Use the verified mapping to write a database migration script or data pipeline transformation. For SQL databases, use ALTER TABLE to rename columns. For document databases, use updateMany with $rename to rename fields in all documents.
Frequently asked questions
How do I perform this rename across millions of MongoDB documents?+
Use MongoDB's $rename aggregation operator in an updateMany command: db.collection.updateMany({}, { $rename: { 'oldFieldName': 'newFieldName', 'accessToken': 'access_token' } }). Test the $rename operation on a small subset with a _id filter before running it on the full collection.
What if some records use the old field name and some already use the new field name?+
Add a filter in your rename query to only process records that still have the old field name: db.collection.updateMany({ oldFieldName: { $exists: true } }, { $rename: { 'oldFieldName': 'newFieldName' } }). Records that already have the new field name are not modified.
Is the migration data transmitted to JAD Apps?+
No. All renaming runs entirely in your browser. Migration data including tokens and user records are never transmitted to JAD Apps servers.
Privacy first
Conversion runs locally in your browser. No file is uploaded — only metadata counters are saved for signed-in dashboard stats.