---
title: "Revert a job"
method: POST
path: "/operations-manager/jobs/{jobId}/revert"
tags: ["Operations Manager"]
---

# Revert a job

`POST /operations-manager/jobs/{jobId}/revert`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/operations-manager/jobs/{jobId}/revert`
- Auth: none declared

Revert a paused Job from an errored Task to a previously completed Task.

## Path parameters

- `jobId` string, required: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.

## Request body

- object
  - `fromTask` string
  - `toTask` union
    - 'workflow_start' | 'workflow_end' | 'error_handler'
    - string

## Response `200`

The result of the revert operation.

- OperationsManagerCommonApiSuccessResponse: A success response from an API method
  - `message` string, required: A human-readable message summarizing the result of the operation
  - `data` unknown, required
  - `metadata` object, required: Any structured, wordy or machine-readable information related to the result of the operation. For success responses, this may contain information like pagination values from a search operation.

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Operations Manager` added
  - api tag `operationsManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/operations-manager/jobs/:jobId/revert/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)