---
title: "Stop Job"
method: POST
path: "/api/jobs/{submission_id}/stop"
---

# Stop Job

`POST /api/jobs/{submission_id}/stop`

## 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/stop/post.ts> (a function with typed inputs; its response is checked against the schema)

Stop a job.

## Path parameters

- `submission_id` string, required

## Response `200`

Whether the job was stopped.

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

## Other responses

- `400`: The job was not submitted via the Ray Jobs API, so it cannot be stopped.
- `404`: The job does not exist.
- `500`: An internal error occurred when stopping the job.

## Changes

- **2026-10-29** `ee468f0281dc`: 1 breaking, 6 info
  - the response's body type changed from `string` to `object` for status `200`
  - response schema `application/json` enum value removed `FAILED`
  - response schema `application/json` enum value removed `PENDING`
  - response schema `application/json` enum value removed `RUNNING`
  - …3 more

[Operation history](https://skmtc.dev/ray-project/apis/ray-jobs-api/changes/api/jobs/:submission_id/stop/post.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)