---
title: "POST /start-import-file-task"
method: POST
path: "/start-import-file-task"
---

# POST /start-import-file-task

`POST /start-import-file-task`

Starts a file import.

## Request body

- object
  - `S3Bucket` string, required — The S3 bucket where the import file is located. The bucket name is required to begin with <code>migrationhub-strategy-</code>.
  - `dataSourceType` 'ApplicationDiscoveryService' | 'MPA' | 'Import' | 'StrategyRecommendationsApplicationDataCollector' — Specifies the source that the servers are coming from. By default, Strategy Recommendations assumes that the servers specified in the import file are available in AWS Application Discovery Service.
  - `groupId` Group[] — Groups the resources in the import file together with a unique name. This ID can be as filter in <code>ListApplicationComponents</code> and <code>ListServers</code>.
    - `name` 'ExternalId' | 'ExternalSourceType' — The key of the specific import group.
    - `value` string — The value of the specific import group.
  - `name` string, required — A descriptive name for the request.
  - `s3bucketForReportData` string — The S3 bucket where Strategy Recommendations uploads import results. The bucket name is required to begin with migrationhub-strategy-.
  - `s3key` string, required — The Amazon S3 key name of the import file.

## Response `200`

Success

- StartImportFileTaskResponse
  - `id` string — The ID for a specific import task. The ID is unique within an AWS account.

## Other responses

- `480` — AccessDeniedException
- `481` — ThrottlingException
- `482` — ServiceQuotaExceededException
- `483` — ValidationException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/migrationhubstrategy.md) · [All operations](https://skmtc.net/aws/apis/migrationhubstrategy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/migrationhubstrategy/revisions/5fde79aed042/schema)