Issue while migration: TF237201

while migration of jira items to ADO work items, i am facing this issue and completely blocked.

Bad response when creating work item - 500 - response body: TF237201: Cannot add a new link because one of the work items being linked will exceed the 1000 link limit. Remove links from that item and try saving again. For more details, please refer to Error when you add link to work item - Azure DevOps | Microsoft Learn.

You’re running into the Azure DevOps error TF237201, which means one of the work items you’re trying to migrate from Jira already has 1,000 links, and Azure DevOps won’t allow more than that per work item. This is a hard platform limit—if you try to add another link, you’ll get a 500 error and the migration will fail.

To resolve this, you’ll need to reduce the number of links on the affected work item in Azure DevOps before continuing your migration. That means either:

  • Removing some existing links from the work item in Azure DevOps, or
  • Adjusting your migration rules to avoid creating additional links for that item.

You can find more about maintaining issue links and hierarchy between Jira and Azure DevOps in Exalate’s documentation:

Once you’ve reduced the number of links below 1,000, you should be able to proceed with your migration. This is a platform constraint, so unfortunately, there’s no workaround to increase the limit.

Let me know if you need more details on how to adjust your sync rules or filter which links get migrated!

Actually we have more than 100 tickets with this error message and couldnt proceed. All the 100 messages doesnt have links and few has a max of 10.

This is blocking the complete migration and we are ignoring those tickets manually to proceed.

Hi @pradheep

Apologies for the late response.

Can you please update us whether you are still facing the issue?

Thanks,

Sonal

Hi @Sonal_Otwani

we havent noticed in recent since w ehave ignored those work items. let me update if we face same issue again.