---
title: "Cancel a job"
method: DELETE
path: "/api/v1/proxy-check/jobs/{id}"
tags: ["Proxy checker API"]
---

# Cancel a job

`DELETE /api/v1/proxy-check/jobs/{id}`

## Request

- Base URL: `https://hproxy.com`
- URL: `https://hproxy.com/api/v1/proxy-check/jobs/{id}`
- Auth: API key in header `X-API-Key`

Stops a queued or running job. What it already answered stays downloadable until it expires, so cancelling a long run is a fine way to say "that is enough of these". A job that has already finished answers `409`; the lines it did not get to are not refunded.

## Path parameters

- `id` string, required

## Query parameters

- `X-API-Key` string, required

## Response `200`

Success

- object

## Other responses

- `400`: Invalid input. The body names the field and the accepted set.
- `401`: Missing or invalid API key.
- `429`: Rate limited. Retry after the delay in the response.

---

[API](https://skmtc.dev/hproxy/apis/hproxy-api.md) · [All operations](https://skmtc.dev/hproxy/apis/hproxy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hproxy/apis/hproxy-api/revisions/9f6898fe76e2?raw)