---
title: "Delete Job"
method: DELETE
path: "/api/jobs/{submission_id}"
---

# Delete Job

`DELETE /api/jobs/{submission_id}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/ray-project/apis/ray-jobs-api/docs/api/jobs/:submission_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a job that is already in a terminal state.

## Path parameters

- `submission_id` string, required

## Response `200`

Whether the job was deleted.

- object
  - `deleted` boolean: Whether the job was deleted.

## Other responses

- `400`: The job was not submitted via the Ray Jobs API, so it cannot be deleted.
- `404`: The job does not exist.
- `500`: An internal error occurred when deleting the job, or the job was not in a terminal state.

## Changes

- **2026-10-29** `ee468f0281dc`: 1 breaking, 1 info
  - the response's body type changed from `boolean` to `object` for status `200`
  - added the optional property `deleted` to the response with the `200` status

[Operation history](https://skmtc.dev/ray-project/apis/ray-jobs-api/changes/api/jobs/:submission_id/delete.md)

---

[API](https://skmtc.dev/ray-project/apis/ray-jobs-api.md) - [All operations](https://skmtc.dev/ray-project/apis/ray-jobs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ray-project/apis/ray-jobs-api/revisions/ee468f0281dc?raw)