---
title: "Modifies a Job resource's status"
method: PUT
path: "/api/v1/experiments/{id}/jobs/{jobId}/status"
tags: ["Experiments"]
---

# Modifies a Job resource's status

`PUT /api/v1/experiments/{id}/jobs/{jobId}/status`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/experiments/{id}/jobs/{jobId}/status`
- Auth: none declared
- TypeScript: <https://skmtc.dev/usnistgov/apis/dioptra-rest-api/docs/api/v1/experiments/:id/jobs/:jobId/status/put.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `X-Fields` string, mask

## Request body

- JobStatusLoad
  - `status` string: The current status of the job. The allowed values are: queued, started, deferred, finished, failed, reset.

## Response `200`

Success

- JobStatusDump
  - `id` integer: ID for the Job resource.
  - `status` string: The current status of the job. The allowed values are: queued, started, deferred, finished, failed, reset.

## Changes

- **2026-09-30** `7615a76631a4`: 2 warning
  - deleted the `path` request parameter `id`
  - deleted the `path` request parameter `jobId`

[Operation history](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/changes/api/v1/experiments/:id/jobs/:jobId/status/put.md)

---

[API](https://skmtc.dev/usnistgov/apis/dioptra-rest-api.md) - [All operations](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/revisions/e1a0ec3a40b2?raw)