---
title: "Review Bulk Job (Cancel or Approve)"
method: POST
path: "/bulk/jobs/{jobId}/review"
tags: ["Bulk Jobs"]
---

# Review Bulk Job (Cancel or Approve)

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

Cancel a queued or processing bulk job by submitting {"action": "reject"}, or resume a paused job with {"action": "approve"}. Completed or failed jobs cannot be reviewed.

## Path parameters

- `jobId` string, uuid, required

## Request body

- object
  - `action` 'approve' | 'reject', required

## Response `200`

Review action confirmed.

- ReviewResponse
  - `jobId` string, uuid, required
  - `status` 'running' | 'canceled', required

## Other responses

- `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
- `429` — Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets
- `500` — Internal Server Error - Something went wrong on our end. **Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io

## Changes

- **2026-08-25** `1f289eff3a26` — 6 breaking
  - the `allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property type/format changed from `string`/`uri` to `string`/`uri-reference` for status `429`
  - the `allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property type/format changed from `string`/`uri` to `string`/`uri-reference` for status `500`
  - the `oneOf[#/components/schemas/InvalidApiKeyError]/allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property type/format changed from `string`/`uri` to `string`/`uri-reference` for status `401`
  - the `oneOf[#/components/schemas/MissingAuthenticationError]/allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property type/format changed from `string`/`uri` to `string`/`uri-reference` for status `401`
  - …2 more

[Change history](https://skmtc.dev/leadmagic/apis/leadmagic-api/changes/bulk/jobs/:jobId/review/post.md)

---

[API](https://skmtc.dev/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.dev/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/revisions/1f289eff3a26/schema)