---
title: "POST /v1/{+parent}/importJobs"
method: POST
path: "/v1/{+parent}/importJobs"
tags: ["projects"]
---

# POST /v1/{+parent}/importJobs

`POST /v1/{+parent}/importJobs`

Creates an import job.

## Path parameters

- `parent` string, required

## Query parameters

- `importJobId` string
- `requestId` string

## Request body

- ImportJob — A resource that represents the background job that imports asset frames.
  - `executionReport` ExecutionReport — A resource that reports result of the import job execution.
    - `executionErrors` ValidationReport — A resource that aggregates errors across import job files.
      - `fileValidations` FileValidationReport[] — List of errors found in files.
        - `fileName` string — The name of the file.
        - `rowErrors` ImportRowError[] — Partial list of rows that encountered validation error.
          - `archiveError` ImportRowErrorArchiveErrorDetails — Error details for an archive file.
            - `csvError` ImportRowErrorCsvErrorDetails — Error details for a CSV file.
              - …
            - `filePath` string — Output only. The file path inside the archive where the error was detected.
          - `rowNumber` integer — The row number where the error was detected.
          - `errors` ImportError[] — The list of errors detected in the row.
            - `errorDetails` string — The error information.
            - `severity` 'SEVERITY_UNSPECIFIED' | 'ERROR' | 'WARNING' | 'INFO' — The severity of the error.
          - `csvError` ImportRowErrorCsvErrorDetails — Error details for a CSV file.
            - `rowNumber` integer — The row number where the error was detected.
          - `vmUuid` string — The VM UUID.
          - `xlsxError` ImportRowErrorXlsxErrorDetails — Error details for an XLSX file.
            - `sheet` string — The name of the sheet where the error was detected.
            - `rowNumber` integer — The row number where the error was detected.
          - `assetTitle` string — Output only. The asset title.
          - `vmName` string — The name of the VM in the row.
        - `partialReport` boolean — Flag indicating that processing was aborted due to maximum number of errors.
        - `fileErrors` ImportError[] — List of file level errors.
          - `errorDetails` string — The error information.
          - `severity` 'SEVERITY_UNSPECIFIED' | 'ERROR' | 'WARNING' | 'INFO' — The severity of the error.
      - `jobErrors` ImportError[] — List of job level errors.
        - `errorDetails` string — The error information.
        - `severity` 'SEVERITY_UNSPECIFIED' | 'ERROR' | 'WARNING' | 'INFO' — The severity of the error.
    - `framesReported` integer — Total number of asset frames reported for the import job.
    - `totalRowsCount` integer — Output only. Total number of rows in the import job.
  - `validationReport` ValidationReport — A resource that aggregates errors across import job files.
    - `fileValidations` FileValidationReport[] — List of errors found in files.
      - `fileName` string — The name of the file.
      - `rowErrors` ImportRowError[] — Partial list of rows that encountered validation error.
        - `archiveError` ImportRowErrorArchiveErrorDetails — Error details for an archive file.
          - `csvError` ImportRowErrorCsvErrorDetails — Error details for a CSV file.
            - `rowNumber` integer — The row number where the error was detected.
          - `filePath` string — Output only. The file path inside the archive where the error was detected.
        - `rowNumber` integer — The row number where the error was detected.
        - `errors` ImportError[] — The list of errors detected in the row.
          - `errorDetails` string — The error information.
          - `severity` 'SEVERITY_UNSPECIFIED' | 'ERROR' | 'WARNING' | 'INFO' — The severity of the error.
        - `csvError` ImportRowErrorCsvErrorDetails — Error details for a CSV file.
          - `rowNumber` integer — The row number where the error was detected.
        - `vmUuid` string — The VM UUID.
        - `xlsxError` ImportRowErrorXlsxErrorDetails — Error details for an XLSX file.
          - `sheet` string — The name of the sheet where the error was detected.
          - `rowNumber` integer — The row number where the error was detected.
        - `assetTitle` string — Output only. The asset title.
        - `vmName` string — The name of the VM in the row.
      - `partialReport` boolean — Flag indicating that processing was aborted due to maximum number of errors.
      - `fileErrors` ImportError[] — List of file level errors.
        - `errorDetails` string — The error information.
        - `severity` 'SEVERITY_UNSPECIFIED' | 'ERROR' | 'WARNING' | 'INFO' — The severity of the error.
    - `jobErrors` ImportError[] — List of job level errors.
      - `errorDetails` string — The error information.
      - `severity` 'SEVERITY_UNSPECIFIED' | 'ERROR' | 'WARNING' | 'INFO' — The severity of the error.
  - `assetSource` string — Required. Reference to a source.
  - `updateTime` string, google-datetime — Output only. The timestamp when the import job was last updated.
  - `displayName` string — Optional. User-friendly display name. Maximum length is 256 characters.
  - `completeTime` string, google-datetime — Output only. The timestamp when the import job was completed.
  - `state` 'IMPORT_JOB_STATE_UNSPECIFIED' | 'IMPORT_JOB_STATE_PENDING' | 'IMPORT_JOB_STATE_RUNNING' | 'IMPORT_JOB_STATE_COMPLETED' | 'IMPORT_JOB_STATE_FAILED' | 'IMPORT_JOB_STATE_VALIDATING' | 'IMPORT_JOB_STATE_FAILED_VALIDATION' | 'IMPORT_JOB_STATE_READY' — Output only. The state of the import job.
  - `labels` object — Labels as key value pairs.
  - `name` string — Output only. The full name of the import job.
  - `createTime` string, google-datetime — Output only. The timestamp when the import job was created.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/migrationcenter.md) · [All operations](https://skmtc.dev/google/apis/migrationcenter/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/migrationcenter/revisions/2a8b4eea0432/schema)