# Cancel execution by ID

Endpoint: POST /executions/{executionId}/cancel
Version: 5.1.43
Security: api_key

## Path parameters:

  - `executionId` (integer, required)
    The ID of the execution to cancel

## Query parameters:

  - `expectedStatus` (string)
    The expected status of the execution to cancel to prevent cancelling a queued job that has transitioned to a running state since the request was issued.
    Enum: "QUEUED", "RUNNING"

  - `graceful` (boolean)
    A cancellation strategy to re-enable SQL objects that were disabled earlier in the execution before terminating.

## Response 200 fields (application/json):

  - `executionId` (integer)
    The ID of the execution for the referenced job. This field is generated by the Masking Engine when a job is run.

  - `jobId` (integer, required)
    The ID of the job that is being executed.
    Example: 167

  - `connectorType` (string)
    The type of the source connector. This field is only used for multi-tenant jobs that are also on-the-fly.
    Enum: "DATABASE", "FILE", "VSAM"

  - `sourceConnectorId` (integer)
    The ID of the source connector. This field is only used for multi-tenant jobs that are also on-the-fly.

  - `targetConnectorId` (integer)
    The ID of the target connector. This field is only used for multi-tenant jobs.

  - `status` (string)
    The status of the execution regarding its completion.
    Enum: "CANCELLED", "FAILED", "QUEUED", "RUNNING", "SUCCEEDED", "WARNING"

  - `rowsMasked` (integer)
    The number of rows masked or profiled so far by this execution. This is not applicable to JSON.

  - `rowsTotal` (integer)
    The total number of rows that this execution should mask or profile. This value is set to -1 while the total row count is being calculated. This is not applicable to JSON.

  - `bytesProcessed` (integer)
    The number of bytes masked or profiled so far by this execution. This is only applicable to JSON files and ASDD profiling jobs on XML files.

  - `bytesTotal` (integer)
    The total number of bytes or profiled that this execution should mask. This value is set to -1 while the total byte count is being calculated. This is only applicable to JSON files and ASDD profiling jobs on XML files.

  - `startTime` (string)
    The date and time that this execution was started.

  - `endTime` (string)
    The date and time that this execution completed.

  - `submitTime` (string)
    The date and time that this execution was submitted.


## Response 400 fields

## Response 403 fields

## Response 404 fields