---
title: "Run Migration From Csv Async"
method: POST
path: "/api/v1/admin/migrations/run-csv-async"
tags: ["Admin APIs", "migrations"]
---

# Run Migration From Csv Async

`POST /api/v1/admin/migrations/run-csv-async`

Run a migration script asynchronously for multiple clients specified in a CSV file path.
Returns immediately with a task ID that can be used to check status.

Args:
    request: CSVFilePathMigrationRequest containing all parameters
    background_tasks: FastAPI BackgroundTasks for async execution

Returns:
    AsyncMigrationResponse with task ID and initial status

## Headers

- `X-Confirm-Destructive` string, nullable

## Request body

- CSVFilePathMigrationRequest
  - `csv_file_path` string, required
  - `script_identifier` string, required
  - `client_id_column` string
  - `send_email_summary` boolean
  - `email_recipients` string[], nullable
  - `parameters` object

## Response `200`

Successful Response

- AsyncMigrationResponse
  - `task_id` string, required
  - `message` string, required
  - `script_identifier` string, required
  - `status` string
  - `csv_file_path` string, required
  - `total_clients` integer, required
  - `submitted_at` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)