Can't find working schema for configuration.json in v16.2.10 – deprecated schema and upgrade action both fail

[JavierGonzalezMartos]

Hi, I'm trying to use Azure DevOps Migration Tools v16.2.10 to migrate work items between two Azure DevOps organizations. However, I'm running into issues with the configuration schema.

When I try to execute the tool with a configuration.json file using the schema from https://devopsmigration.io/schema/configuration.schema.json, I get the following error:

"Error when resolving schema reference 'https://devopsmigration.io/schema/configuration.schema.json'
Unexpected token encountered when reading value for 'prefixItems'. Expected StartArray, got StartObject."

I also tried using the old v1 schema and then running the upgrade action, but that also fails due to version-related errors.

I’ve followed the official documentation but it’s unclear which schema version should be used with the current version of the tool. Even the latest schema seems to fail validation or execution.

Here’s what I’ve tried so far:

• Using the legacy schema → version error
• Using the latest schema → fails to resolve
• Using --skipVersionCheck → bypasses version check, but processors and endpoint structures still throw errors
• Reinstalled the tool via winget, but installation shows hash mismatch and doesn't run properly

Could someone please share:

1. A minimal working configuration.json example that works with version 16.2.10 for migrating work items?
2. Confirmation of the correct $schema URL to use?
3. Whether there are breaking changes in how the schema is structured (e.g., Endpoints as arrays, FieldMaps moved out of CommonTools, etc.)

Thanks in advance for any help you can provide!

[MrHinsh]

I was able to validate the schema online

Do you know if your network might be blocking access to the schema? Proxy server maybe?

[MrHinsh]

never mind... it may be a deeper issue

[MrHinsh]

Nope... I was just able to create a config with devopsmigration init --template Basic and execute it with devopsmigration execute -c "configuration.json".

{
  "$schema": "https://devopsmigration.io/schema/configuration.schema.json",
  "Serilog": {
    "MinimumLevel": "Information"
  },
  "MigrationTools": {
    "Version": "16.2",
    "Endpoints": {
      "Source": {
        "EndpointType": "TfsTeamProjectEndpoint",
        "Collection": "https://dev.azure.com/nkdagility-preview/",
        "Project": "migrationSource1",
        "Authentication": {
          "AuthenticationMode": "AccessToken",
          "NetworkCredentials": {
            "Domain": "",
            "UserName": "",
            "Password": "** removed as a secret ***"
          },
          "AccessToken": "** removed as a secret ***"
        },
        "ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
        "LanguageMaps": {
          "AreaPath": "Area",
          "IterationPath": "Iteration"
        }
      },
      "Target": {
        "EndpointType": "TfsTeamProjectEndpoint",
        "Collection": "https://dev.azure.com/nkdagility-preview/",
        "Project": "migrationSource1",
        "Authentication": {
          "AuthenticationMode": "AccessToken",
          "NetworkCredentials": {
            "Domain": "",
            "UserName": "",
            "Password": "** removed as a secret ***"
          },
          "AccessToken": "** removed as a secret ***"
        },
        "ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
        "LanguageMaps": {
          "AreaPath": "Area",
          "IterationPath": "Iteration"
        }
      }
    },
    "Processors": [
      {
        "ProcessorType": "TfsWorkItemMigrationProcessor",
        "Enabled": false,
        "UpdateCreatedDate": true,
        "UpdateCreatedBy": true,
        "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
        "FixHtmlAttachmentLinks": true,
        "WorkItemCreateRetryLimit": 5,
        "FilterWorkItemsThatAlreadyExistInTarget": false,
        "GenerateMigrationComment": true,
        "SourceName": "Source",
        "TargetName": "Target"
      }
    ],
    "CommonTools": {
      "FieldMappingTool": {
        "Enabled": true,
        "FieldMaps": [
          {
            "FieldMapType": "FieldLiteralMap",
            "targetField": "Custom.SomeField",
            "value": "New field value",
            "ApplyTo": [
              "SomeWorkItemType"
            ]
          }
        ]
      }
    }
  }
}

[MrHinsh]

Could you share your config?