> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /kill/proc

```
URL: http://<db.host>:<db.port>/kill/proc
```

Kills a running proc instance.

## Input Parameter Description

<ParamField body="run_id" type="string">
  The run ID of a running proc instance. If a proc with a matching run ID is not found or the proc instance has already completed, no procs will be killed. If not specified, all running proc instances will be killed.

  The default value is ''.
</ParamField>

<ParamField body="options" type="map of string to strings">
  Optional parameters.

  The default value is an empty map ( \{} ).

  <Expandable title="options">
    <ParamField body="run_tag">
      If input parameter *run\_id* is specified, kill the proc instance that has a matching run ID and a matching run tag that was provided to [/execute/proc](/content/api/rest/execute_proc_rest). If input parameter *run\_id* is not specified, kill the proc instance(s) where a matching run tag was provided to [/execute/proc](/content/api/rest/execute_proc_rest).

      The default value is ''.
    </ParamField>

    <ParamField body="clear_execute_at_startup">
      If *true*, kill and remove the instance of the proc matching the auto-start run ID that was created to run when the database is started. The auto-start run ID was returned from [/execute/proc](/content/api/rest/execute_proc_rest) and can be retrieved using [/show/proc](/content/api/rest/show_proc_rest).

      The default value is `false`.

      The supported values are:

      * true
      * false
    </ParamField>
  </Expandable>
</ParamField>

## Output Parameter Description

The Kinetica server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query.  Here is a description of the various fields of the wrapper:

<ResponseField name="status" type="String">
  'OK' or 'ERROR'
</ResponseField>

<ResponseField name="message" type="String">
  Empty if success or an error message
</ResponseField>

<ResponseField name="data_type" type="String">
  'kill\_proc\_response' or 'none' in case of an error
</ResponseField>

<ResponseField name="data" type="String">
  Empty string
</ResponseField>

<ResponseField name="data_str" type="JSON or String">
  This embedded JSON represents the result of the /kill/proc endpoint:

  <Expandable title="data_str">
    <ResponseField name="run_ids" type="array of strings">
      List of run IDs of proc instances that were killed.
    </ResponseField>

    <ResponseField name="info" type="map of string to strings">
      Additional information.
    </ResponseField>
  </Expandable>

  Empty string in case of an error.
</ResponseField>