---
title: "cancelBulkAction"
method: POST
path: "/v1/entity/taxonomies/bulk-jobs/{job_id}/cancel"
tags: ["Taxonomy"]
---

# cancelBulkAction

`POST /v1/entity/taxonomies/bulk-jobs/{job_id}/cancel`

## Request

- Base URL: `https://entity.sls.epilot.io`
- URL: `https://entity.sls.epilot.io/v1/entity/taxonomies/bulk-jobs/{job_id}/cancel`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-epilot-org-id`

Cancels a running bulk action job. The job status will be updated to CANCELLED
and the job will be stopped.

## Path parameters

- `job_id` string, required

## Response `200`

Success

- TaxonomyBulkJob
  - `job_id` string, uuid
  - `job_status` 'PENDING' | 'FAILED' | 'COMPLETED' | 'CANCELLED': The status of the bulk job
  - `failure_reason` string
  - `action_type` 'MOVE_CLASSIFICATIONS' | 'MERGE_CLASSIFICATIONS' | 'DELETE_CLASSIFICATIONS'
  - `request` object
    - `target_taxonomy` string: URL-friendly name for taxonomy
    - `target_classification` string
    - `classification_ids` ClassificationId[]
  - `output` object
    - `target_entities_count` number
    - `affected_entities_count` number
    - `failures_count` number
    - `failed_entities` EntityId[]
  - `created_by` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `org` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/epilot/apis/entity-api.md) - [All operations](https://skmtc.dev/epilot/apis/entity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/epilot/apis/entity-api/revisions/b7d4f45d1518?raw)