action jira_connect_to_forge_migration_fetch_task_resource_fetch_migration_t {
  label: "Get Connect issue field migration task"
  description: "Returns the details of a Connect issue field's migration to Forge.\n\nWhen migrating a Connect app to Forge, [Issue Field](https://developer.atlassian.com/cloud/jira/software/modules/issue-field/) modules\nmust be converted to [Custom field](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/). When the\nForge version of the app is installed, Forge creates a\n[background task](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/#api-group-tasks) to track the\nmigration of field data across. This endpoint returns the status and other details of that background task.\n\nFor more details, see\n[Jira modules > Jira Custom Fields](https://developer.atlassian.com/platform/adopting-forge-from-connect/migrate-jira-custom-fields/).\n\n**[Permissions](#permissions) required:** Only Connect and Forge apps can make this request."
  provider: jira
  method: GET
  path: "/rest/atlassian-connect/1/migration/{connectKey}/{jiraIssueFieldsKey}/task"
  encoding: json
  input: {
    type: "object"
    properties: {
      connectKey: {
        type: "string"
      }
      jiraIssueFieldsKey: {
        type: "string"
      }
    }
    required: ["connectKey", "jiraIssueFieldsKey"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Details about a task."
    required: ["elapsedRuntime", "id", "lastUpdate", "progress", "self", "status", "submittedBy"]
    properties: {
      description: {
        type: "string"
        description: "The description of the task."
      }
      elapsedRuntime: {
        type: "integer"
        format: "int64"
        description: "The execution time of the task, in milliseconds."
      }
      finished: {
        type: "string"
        format: "date-time"
        description: "A timestamp recording when the task was finished."
      }
      id: {
        type: "string"
        description: "The ID of the task."
      }
      lastUpdate: {
        type: "string"
        format: "date-time"
        description: "A timestamp recording when the task progress was last updated."
      }
      message: {
        type: "string"
        description: "Information about the progress of the task."
      }
      progress: {
        type: "integer"
        format: "int64"
        description: "The progress of the task, as a percentage complete."
      }
      result: {
        description: "The result of the task execution."
        type: "object"
      }
      self: {
        type: "string"
        format: "uri"
        description: "The URL of the task."
      }
      started: {
        type: "string"
        format: "date-time"
        description: "A timestamp recording when the task was started."
      }
      status: {
        type: "string"
        description: "The status of the task."
        enum: ["ENQUEUED", "RUNNING", "COMPLETE", "FAILED", "CANCEL_REQUESTED", "CANCELLED", "DEAD"]
      }
      submitted: {
        type: "string"
        format: "date-time"
        description: "A timestamp recording when the task was submitted."
      }
      submittedBy: {
        type: "integer"
        format: "int64"
        description: "The ID of the user who submitted the task."
      }
    }
  }
}