This resource supports the migration of some Connect modules to their equivalent Forge modules.
Returns the details of a Connect issue field's migration to Forge.
When migrating a Connect app to Forge, Issue Field modules must be converted to Custom field. When the Forge version of the app is installed, Forge creates a background task 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.
Permissions required: Only Connect and Forge apps can make this request.
read:jira-workConnect app scope required: NONE
string
Requiredstring
RequiredReturned if the request is successful and a migration task is found.
Details about a task.
1
2
3
4
5
6
7
8
9
10
11
12
// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";
const response = await requestJira(`/rest/atlassian-connect/1/migration/{connectKey}/{jiraIssueFieldsKey}/task`, {
headers: {
'Accept': 'application/json'
}
});
console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"description": "<string>",
"elapsedRuntime": 48,
"finished": "<string>",
"id": "<string>",
"lastUpdate": "<string>",
"message": "<string>",
"progress": 51,
"self": "<string>",
"started": "<string>",
"status": "ENQUEUED",
"submitted": "<string>",
"submittedBy": 42
}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 modules must be converted to 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.
Permissions required: Only Connect and Forge apps can make this request.
read:jira-workConnect app scope required: NONE
string
Requiredstring
RequiredReturned if the migration task was submitted successfully.
1
2
3
4
5
6
7
8
9
10
// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";
const response = await requestJira(`/rest/atlassian-connect/1/migration/{connectKey}/{jiraIssueFieldsKey}/task`, {
method: 'POST'
});
console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.text());Rate this page: