[I ran into an issue] Step 1: Start migration Existing chat migration -- {"error":{"code":"PreconditionFailed"

[jonnyguo1988]

Type of issue

Feature doesn't work (bug)

Feedback

The api https://learn.microsoft.com/en-us/graph/api/chat-startmigration?view=graph-rest-beta&tabs=http got PreconditionFailed error for OneOnOne chat. Double checked it works with group chat.

Request:- {Method: POST, RequestUri: 'https://graph.microsoft.com/beta/chats/19:33f61913-6889-4171-b0e5-eca115831bbb_bf28dd13-801e-4f70-b12d-97087b57a7f0@unq.gbl.spaces/startMigration', Version: 1.1, Content: {"conversationCreationDateTime":"2022-02-24T23:56:40Z"}, Headers:
{
Authorization: Bearer ***
Content-Type: application/json; charset=utf-8
Content-Length: 55
}}

Response

{"error":{"code":"PreconditionFailed","message":"PreconditionFailed","innerError":{"code":"1","message":"PreconditionFailed-Version mismatch for thread resource.","date":"2026-04-13T05:51:05","request-id":"eb1517d3-489e-4507-abab-0e6fbd674be9","client-request-id":"eb1517d3-489e-4507-abab-0e6fbd674be9"}}}

Page URL

https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams#step-five-add-team-members

Content source URL

https://github.com/MicrosoftDocs/msteams-docs/blob/main/msteams-platform/graph-api/import-messages/import-external-messages-to-teams.md

Author

@AkJo

Document Id

ce77e760-90cf-e6b1-3cec-ae55ee50c33e

Platform Id

c9cc8ad3-6c28-7c8c-af03-219bbefa1d38

[m365-agent-toolkit-assistant]

👋 Hi @jonnyguo1988,

Thank you for reporting this issue! We want to let you know that:

⏱️ Our team will personally review your issue
🎯 You can expect a response within 1 business day

✨ This is an AI-generated initial response
🤖 AI-Generated Preliminary Analysis:

Classification: Upstream — the docs say existing 1:1 chats are supported for chat:startMigration, so a PreconditionFailed-Version mismatch for thread resource on only one-on-one chats points to a Graph/Teams service-side issue, not expected behavior.

• Official Graph doc for chat:startMigration lists Chats: Group, 1:1 | New and existing as supported.
• The import guidance also says existing chats are supported and that migration mode should return 204 No Content when successful.
• Your repro shows group chat works, but 1:1 chat fails with PreconditionFailed-Version mismatch for thread resource, which is inconsistent with the documented support matrix.
• No duplicate/root-cause guidance was found in the docs repo beyond this report.

Upgrade check: Not applicable/unverified — this is a service API issue; no repo changelog fix applies.

What to do now:

1. Treat this as a Microsoft Graph/Teams backend issue.
2. Open a Microsoft Graph support ticket with the request-id eb1517d3-489e-4507-abab-0e6fbd674be9 and timestamp 2026-04-13T05:51:05.
3. Include a successful group chat repro and failing 1:1 chat repro.
4. As a temporary workaround, use group chat migration where possible.

Useful links:

• https://learn.microsoft.com/graph/api/chat-startmigration?view=graph-rest-beta
• https://learn.microsoft.com/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams
• [I ran into an issue] Step 1: Start migration Existing chat migration -- {"error":{"code":"PreconditionFailed" #14265

If you want, I can help draft the support ticket wording.

---

Note: This is an automated first response generated by AI. A human team member will review your issue and provide a more detailed response soon. We appreciate your patience!

[Nivedipa-MSFT]

Hello @jonnyguo1988,
startMigration returns PreconditionFailed due to a version mismatch for 1:1 chats, but it works for group chats.

Reason: The 1:1 chat thread already exists in Teams (auto-provisioned), causing a version conflict with the migration request.

Solution:

• Create the 1:1 chat in migration mode first using POST /chats with chatType: oneOnOne and a historical createdDateTime, then call startMigration on the new thread
• Do not use an existing or pre-provisioned 1:1 thread ID, as migration into already-existing 1:1 chats is not supported

Please let us know if you have any other query here.

[jonnyguo1988]

Hi @Nivedipa-MSFT ,
It's very nice to have your quick response here!

While seems enter migration mode for existing chat is documented here
https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams#existing-chat-migration

I'm following this document to do the development. And also, in Chat api, create chat in migration mode isn't there. https://learn.microsoft.com/en-us/graph/api/chat-post?view=graph-rest-beta&tabs=http

[evanypark]

@jonnyguo1988 @Nivedipa-MSFT
StartChatMigration API requires following conditions to be successful:

• Caller Application has Teamwork.MIgrate.All permission
• Target Chat is currently NOT in migration mode (Including if target chat was created in migration mode. But chats cannot be created in migration mode atm).

As long as above conditions are met, it should be successful.

Our engineers are looking into the issue. Will update on this soon

[jonnyguo1988]

@evanypark
Thank you for the clarify, I double checked my application has Teamwork.Migrate.All permission

[Nivedipa-MSFT]

Hello @evanypark - Could you please share any update here.