> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# automation-cancel

> Cancels one automation based on the provided automation ID.

## Purpose

This automation **cancels one automation** based on the provided automation ID.

### automation-cancel

API used:

```
/operations-manager/jobs/cancel/
```

### Input

| Inputs           | Data Type         | Sample Input                         | Description                                                     |
| ---------------- | ----------------- | ------------------------------------ | --------------------------------------------------------------- |
| instance\_name   | Dropdown (String) | SE Lab Prod 2023.1                   | The Itential Platform instance name                             |
| automation\_id   | String            | 4278c701b83943b08a98\*\*\*           | The Automation ID of the Automation that needs to be cancelled. |
| token (optional) | String            | 9f0999c2-7054-4820-8eeb-c3052d30acaa | Authentication token or empty if an API key is used             |

### Output

| Output  | Data Type | Sample Output                                       | Description     |
| ------- | --------- | --------------------------------------------------- | --------------- |
| Message | String    | Successfully canceled job 24fe09ed634a461b987\*\*\* | Success Message |

### Error Output

| Error Output   | Data Type | Sample Output                                                                                                                                            | Description   |
| -------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| error\_message | String    | `{"metadata":{},"data":{"4f874bd834174ae78a56f3**":"Cannot cancel job 4f874bd834174ae78a56f** that is canceled"},"message":"Failed to cancel all jobs"}` | Error Message |