> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weborion.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel a batch job

> Cancels a batch job. Only items still **In Queue** are stopped — items already being processed cannot be cancelled. The batch job record is retained after cancellation.



## OpenAPI

````yaml /openapi.json delete /api/v1/batch_jobs/{batch_job_id}
openapi: 3.0.3
info:
  title: WebOrion Monitor API
  description: >-
    REST API for managing webpages, alerts, batch jobs, and activity logs in
    WebOrion Defacement Monitor.
  version: '2021-07-26'
servers:
  - url: https://api.monitor.weborion.io
security:
  - bearerAuth: []
tags:
  - name: User
    description: Operations related to user accounts
  - name: Webpages
    description: Operations related to webpages and URLs
  - name: Batch Jobs
    description: Operations related to batch baseline and rebaseline jobs
  - name: Alerts
    description: Operations related to alerts
  - name: Domains
    description: Operations related to domains
  - name: Tags
    description: Operations related to tags for organising webpages
paths:
  /api/v1/batch_jobs/{batch_job_id}:
    delete:
      tags:
        - Batch Jobs
      summary: Cancel a batch job
      description: >-
        Cancels a batch job. Only items still **In Queue** are stopped — items
        already being processed cannot be cancelled. The batch job record is
        retained after cancellation.
      operationId: cancelBatchJob
      parameters:
        - in: path
          name: batch_job_id
          schema:
            type: string
          required: true
          description: Batch job ID (including prefix)
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Generate an API token from the WebOrion Defacement Monitor portal. Pass
        it as `Authorization: Bearer <token>`.

````