---
title: "Submit Connect issue field migration task"
method: POST
path: "/rest/atlassian-connect/1/migration/{connectKey}/{jiraIssueFieldsKey}/task"
tags: ["Migration of Connect modules to Forge"]
---

# Submit Connect issue field migration task

`POST /rest/atlassian-connect/1/migration/{connectKey}/{jiraIssueFieldsKey}/task`

Submits a request to trigger migration of connect issue field to its Forge custom field counterpart.

When migrating a Connect app to Forge, [Issue Field](https://developer.atlassian.com/cloud/jira/software/modules/issue-field/) modules
must be converted to [Custom field](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/) modules.
This endpoint triggers the background migration of field data. Use the GET endpoint to retrieve
the status and progress of the task.

For more details, see
[Jira modules > Jira Custom Fields](https://developer.atlassian.com/platform/adopting-forge-from-connect/migrate-jira-custom-fields/).

**[Permissions](#permissions) required:** Only Connect and Forge apps can make this request.

## Path parameters

- `connectKey` string, required
- `jiraIssueFieldsKey` string, required

## Query parameters

- `retriggerCompletedMigration` boolean

## Response `202`

Returned if the migration task was submitted successfully.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `404` — Returned if no migrated Forge module with the given key is found.
- `409` — Returned if a migration task is already in progress for the field.

## Changes

- **2026-07-26** `53c68b8bb673` — 1 info
  - added the new optional `query` request parameter `retriggerCompletedMigration`

[Change history](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/changes/rest/atlassian-connect/1/migration/:connectKey/:jiraIssueFieldsKey/task/post.md)

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/revisions/7e9af75061ea/schema)