---
updatedAt: 2026-06-11T16:06:12.000Z
agentTools:
  projectIndex: https://cloud.docs.tamr.com/llms.txt
---

# stop

Signal a job to stop.

* If the job is `PENDING`, it will immediately transition to `DONE`.
* If the job is `RUNNING`, then the job will interrupt its work and terminate.
* If the job is `DONE`, `stop` has no effect.

*Note*: this is an asynchronous operation and it may take some time before a `RUNNING` job transitions to `DONE`. In fact, a job may still succeed or fail after `stop` has been signalled. Users should monitor job status with `get` until the job is `DONE`.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Jobs",
    "version": "v1beta1"
  },
  "tags": [
    {
      "name": "tamr.api.v1beta1.Jobs"
    }
  ],
  "paths": {
    "/api/v1beta1/jobs/{jobId}:stop": {
      "post": {
        "summary": "stop",
        "description": "Signal a job to stop.\n\n* If the job is `PENDING`, it will immediately transition to `DONE`.\n* If the job is `RUNNING`, then the job will interrupt its work and terminate.\n* If the job is `DONE`, `stop` has no effect.\n\n*Note*: this is an asynchronous operation and it may take some time before a `RUNNING` job transitions to `DONE`. In fact, a job may still succeed or fail after `stop` has been signalled. Users should monitor job status with `get` until the job is `DONE`.",
        "operationId": "Jobs_StopJob",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tamr.api.v1beta1.StopJobResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "jobId",
            "description": "Required. ID of the job to stop.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tamr.api.v1beta1.Jobs.StopJobBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "tamr.api.v1beta1.Jobs"
        ]
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "X-API-KEY",
        "value": "example-api-key"
      }
    ]
  },
  "servers": [
    {
      "url": "https://api-examples.tamr.cloud"
    }
  ],
  "components": {
    "schemas": {
      "tamr.api.v1beta1.Jobs.StopJobBody": {
        "type": "object"
      },
      "tamr.api.v1beta1.StopJobResponse": {
        "type": "object"
      }
    }
  }
}
```