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

# Run Migration From Csv

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

Run a migration script for multiple clients specified in a CSV file.

Args:
    csv_file: CSV file containing client IDs
    script_identifier: The migration script to run
    client_id_column: Name of the column containing client IDs (default: "client_id")
    background_tasks: Background task handler
    client_service: ClientService instance

Returns:
    CSVMigrationResponse with processing results

## Query parameters

- `script_identifier` string, required
- `client_id_column` string
- `send_email_summary` boolean
- `email_recipients` string, nullable

## Headers

- `X-Confirm-Destructive` string, nullable

## Response `200`

Successful Response

- CSVMigrationResponse
  - `message` string, required
  - `script_identifier` string, required
  - `status` string, required
  - `total_clients` integer, required
  - `processed_clients` integer
  - `successful_migrations` integer
  - `failed_migrations` integer
  - `skipped_migrations` integer
  - `errors` string[]
  - `email_sent` boolean
  - `email_recipients` string[], nullable

## 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)