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

# Get Connect issue field migration task

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

Returns the details of a Connect issue field's migration to Forge.

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/). When the
Forge version of the app is installed, Forge creates a
[background task](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/#api-group-tasks) to track the
migration of field data across. This endpoint returns the status and other details of that background 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

## Response `200`

Returned if the request is successful and a migration task is found.

- TaskProgress — Details about a task.
  - `description` string — The description of the task.
  - `elapsedRuntime` integer, required — The execution time of the task, in milliseconds.
  - `finished` string, date-time — A timestamp recording when the task was finished.
  - `id` string, required — The ID of the task.
  - `lastUpdate` string, date-time, required — A timestamp recording when the task progress was last updated.
  - `message` string — Information about the progress of the task.
  - `progress` integer, required — The progress of the task, as a percentage complete.
  - `result` unknown
  - `self` string, uri, required — The URL of the task.
  - `started` string, date-time — A timestamp recording when the task was started.
  - `status` 'ENQUEUED' | 'RUNNING' | 'COMPLETE' | 'FAILED' | 'CANCEL_REQUESTED' | 'CANCELLED' | 'DEAD', required — The status of the task.
  - `submitted` string, date-time — A timestamp recording when the task was submitted.
  - `submittedBy` integer, required — The ID of the user who submitted the task.

## 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. * no ongoing migration task exists for the custom field.

---

[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)