---
title: "Restart a Bulk Job"
method: POST
path: "/bulk/jobs/{jobId}/restart"
tags: ["Bulk Jobs"]
---

# Restart a Bulk Job

`POST /bulk/jobs/{jobId}/restart`

Restart a bulk job in full, from failed rows, or from a specified position.

## Path parameters

- `jobId` string, uuid, required

## Request body

- object
  - `mode` 'full' | 'failed_only' | 'from_row' | 'from_shard' — Which rows to reprocess.
  - `startRowIndex` integer — Zero-based row to restart from. Required when `mode` is `from_row`.
  - `startShardIndex` integer — Zero-based shard to restart from. Required when `mode` is `from_shard`.

## Response `200`

Restart accepted.

- object

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key
- `404` — Not Found - The requested resource could not be found. **Common causes:** - Profile doesn't exist or is not accessible - Company not found in our database - Invalid URL or identifier

---

[API](https://skmtc.net/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.net/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/versions/e95809714e4d/schema)
