---
title: "Kill job"
method: POST
path: "/{env_id}/{flow_id}/{tenant}/jobs/kill"
---

# Kill job

`POST /{env_id}/{flow_id}/{tenant}/jobs/kill`

## Request

- Base URL: `https://api.hotglue.com`
- URL: `https://api.hotglue.com/{env_id}/{flow_id}/{tenant}/jobs/kill`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/hotglue/apis/hotglue-api/docs/:env_id/:flow_id/:tenant/jobs/kill/post.ts> (a function with typed inputs; its response is checked against the schema)

End any running processes for a job. Provide exactly one of `job_root`, `job_id`, or `external_job_id`.

## Path parameters

- `env_id` string, required
- `flow_id` string, required
- `tenant` string, required

## Request body

- union
  - object
    - `job_root` string, required: S3 root of this job
    - `job_id` string: ID of this job
    - `external_job_id` string: External ID of this job
    - `reason` string: Reason for killing this job
  - object
    - `job_root` string: S3 root of this job
    - `job_id` string, required: ID of this job
    - `external_job_id` string: External ID of this job
    - `reason` string: Reason for killing this job
  - object
    - `job_root` string: S3 root of this job
    - `job_id` string: ID of this job
    - `external_job_id` string, required: External ID of this job
    - `reason` string: Reason for killing this job

## Response `200`

200

- object

## Other responses

- `400`: 400

## Changes

- **2026-09-22** `90c0c21398cc`: 4 info
  - added the new optional request property `external_job_id`
  - added the new optional request property `job_id`
  - added `subschema #1, subschema #2, subschema #3` to the request body `oneOf` list
  - the request property `job_root` became optional
- **2026-07-31** `30ff54d01ec0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hotglue/apis/hotglue-api/changes/:env_id/:flow_id/:tenant/jobs/kill/post.md)

---

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