---
title: "Cancel a job"
method: DELETE
path: "/api/v1/jobs/{jobId}"
tags: ["job"]
---

# Cancel a job

`DELETE /api/v1/jobs/{jobId}`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/cmsgov/apis/beneficiary-claims-data-api/docs/api/v1/jobs/:jobId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Cancels a currently running job.

## Path parameters

- `jobId` integer, required

## Response `202`

The job has been cancelled. No data will be available for download.

## Other responses

- `400`: There was a problem with the request. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html
- `401`: Unauthorized. The provided credentials are invalid for the requested resource.
- `404`: The requested path was not found. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html
- `410`: The requested resource is no longer available. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html

---

[API](https://skmtc.dev/cmsgov/apis/beneficiary-claims-data-api.md) - [All operations](https://skmtc.dev/cmsgov/apis/beneficiary-claims-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cmsgov/apis/beneficiary-claims-data-api/revisions/3565bdea5a5f?raw)
